Add line items to an existing Ramp Plus purchase order.

Archive a bill, cancelling inflight payments or terminating its one-time card where possible. Paid and batch-payment bills cannot be archived.

Archive a Ramp Plus purchase order. This destructive operation is irreversible.

Create a Ramp bill. Ramp does not support creating batch payments through this API.

Tool for creating a new department in your Ramp organization. Perfect for setting up organizational structure and expense categorization.

Beta: create a Ramp draft bill for a vendor without submitting it.

Tool to create a new inventory item accounting field for tracking inventory categories. Use when setting up inventory tracking for an accounting connection. Note: There can only be one active inventory item accounting field per accounting connection.

Tool for uploading a new memo for a transaction in Ramp. Use when you need to add notes or context to existing transactions.

Tool to create a mileage reimbursement in Ramp. Use when a user needs to submit a reimbursement for business-related travel distance. Requires distance, reimbursee_id, and trip_date as mandatory fields.

Tool for creating a new custom accounting field. Note: This operation requires elevated permissions not available in the demo API.

Create a purchase order. Purchase Orders require a Ramp Plus account.

Tool to create a new tax code accounting field in Ramp. There can only be one active tax code accounting field per accounting connection. Use when you need to set up tax code tracking for an accounting integration.

Tool to create a user invite for onboarding new employees to Ramp. Triggers an async task to send an invite email. Users must accept the invite to be onboarded. Assign users to specific entities using location_id.

Tool to create a new webhook subscription for receiving event notifications from Ramp. Use when you need to set up real-time notifications for events like transactions, bills, or reimbursements. The newly registered subscription will be in pending verification state and requires endpoint verification with the provided challenge.

Tool to deactivate a user in your Ramp organization. Use when you need to prevent a user from logging in, spending on cards, or receiving notifications. Once deactivated, users cannot access their Ramp account or perform any actions.

Tool to delete a general ledger account from Ramp. Use when you need to remove a GL account from the accounting system.

Tool to disconnect the current active API-based accounting connection. Use when you need to disable the accounting integration. This action will clear associated accounting settings including Custom Fields, GL Accounts, and Vendors. Only API-based connections can be disconnected via this endpoint.

Tool to delete a custom accounting field from Ramp. Use when you need to remove a custom accounting field from the system. Note: Fields are read-only and cannot be deleted when a direct accounting connection is enabled.

Tool to delete an accounting inventory item option from Ramp. Use when you need to remove an inventory item option from the accounting system.

Tool to delete the tax code accounting field from Ramp. Use when you need to remove the tax code field configuration. Note: The tax code field must exist before deletion.

Tool to delete a tax code option from Ramp. Use when you need to remove a tax code option from the accounting system.

Tool to delete an accounting tax rate from Ramp. Use when you need to remove a tax rate from the accounting system.

Tool to delete an accounting vendor from Ramp. Use when you need to remove a vendor from the accounting system.

Tool to delete a custom accounting field option from Ramp. Use when you need to remove a specific option from a custom accounting field.

Tool to delete the inventory item accounting field from Ramp. Use when you need to remove the inventory item field from the accounting connection. This uses the authenticated connection's context to identify which inventory item field to delete.

Delete one line item from an approved Ramp Plus purchase order.

Tool to remove users from a shared spend limit in Ramp. Use when you need to revoke a user's access to a shared spending allocation.

Tool to delete a webhook subscription by ID. Use when you need to remove a webhook subscription from Ramp. The operation is irreversible and returns no content on success.

Download the remittance receipt PDF for a Ramp bill.

Tool to fetch a specific general ledger account by ID from Ramp. Use when you need to retrieve detailed information about a single GL account.

Tool to fetch a specific accounting vendor by ID from Ramp. Use when you need to retrieve detailed information about a single accounting vendor for coding transactions, reimbursements, bills, or purchase orders.

Tool for fetching a custom accounting field.

Tool to list general ledger accounts from Ramp. Use when you need to retrieve GL accounts for accounting integration or transaction categorization.

Tool to fetch all accounting connections for the current Ramp business. Use when you need to view all accounting integrations, including both active and inactive connections.

Tool to fetch the current active accounting connection for a Ramp account. Use when you need to check the status, type, or configuration of the active accounting integration with providers like QuickBooks or NetSuite.

Tool to fetch a specific accounting connection by ID from Ramp. Use when you need to retrieve detailed information about a particular accounting integration.

Tool to list custom accounting fields for coding transactions. Use when you need to retrieve custom accounting fields that can be leveraged to code transactions, reimbursements, and bills.

Tool to list accounting vendors from Ramp. Use when you need to retrieve vendor data for transaction coding, reimbursements, bills, or purchase orders in the accounting system.

Get all the transactions.

Fetch one Ramp bill by ID, including its coding, line items, and payment.

Tool for retrieving detailed information about a specific card. Returns comprehensive card details including spending limits, cardholder info, and fulfillment status. Use this to get complete card profile for analysis or troubleshooting.

Tool to fetch a card's sensitive details from the vault. Requires vault API access. Use when you need to retrieve PAN or CVV for a specific card. This endpoint uses a separate vault base URL.

Tool to fetch a custom accounting field option by its ID. Use when you need to retrieve details about a specific custom accounting field option from Ramp's accounting integration.

Tool for retrieving detailed information about a specific department. Returns comprehensive department details including hierarchy information. Use this to get complete department profile for organizational analysis.

Beta: retrieve one Ramp draft bill by its unique identifier.

Tool to fetch inventory item accounting field for the current accounting connection. Use when you need to retrieve the inventory item field configuration from the connected ERP system.

Tool to fetch a transaction memo. Use when you need to retrieve the memo text associated with a specific transaction.

Fetch a Ramp Plus purchase order and its detailed line items.

Tool for retrieving complete details of a specific reimbursement. Includes amount, status, user information, accounting details, receipts, and sync status. Use this to get comprehensive reimbursement information for approval workflows or detailed analysis.

Tool to fetch detailed information about a specific spend limit. Use when you need to retrieve comprehensive limit details including balance, restrictions, linked cards, and users.

Tool for retrieving statement details or downloading statements. Supports JSON, PDF, and CSV formats for financial reporting.

Tool for retrieving complete details of a specific transaction. Includes merchant details, receipts, accounting codes, and dispute information.

Tool to retrieve detailed information about a specific Ramp user by their ID. Use when you need complete user profile information including role, status, department, and custom fields.

Tool for fetching the status of a deferred user task. Use when you need to check the progress or outcome of asynchronous user operations like user creation.

Tool for retrieving detailed information about a specific vendor. Returns comprehensive vendor details including spending totals, category, and contact information. Use this to get complete vendor profile for analysis or updates.

Tool to retrieve detailed information about a specific webhook subscription by ID. Use when you need to check webhook configuration, status, or event types.

Beta: place a Ramp bill on hold, blocking all payment rails and descheduling payments.

Tool for issuing virtual cards to users instantly. Creates cards with customizable spending limits and restrictions. Returns full card details including card number and CVV.

Tool to list accounting inventory item options from Ramp. Use when you need to retrieve inventory items for accounting integration or transaction categorization.

Tool to list tax rates from Ramp's accounting integration. Use when you need to retrieve tax rate information for transaction categorization or tax compliance.

List Ramp bills using payment, status, accounting, date, and amount filters.

Tool for listing all cards across the organization with optional filters. Returns card details including spending limits, cardholder info, and state. Use this to analyze card distribution, monitor card states, or find specific cards.

Tool for listing all departments in the organization. Returns department details including names, codes, and hierarchy information. Use this to analyze organizational structure and department relationships.

Beta: list Ramp draft bills with filters and cursor pagination.

Tool for listing memos associated with transactions in your Ramp organization. Returns memo details with support for filtering by card, user, department, location, manager, merchant, and date range.

List and filter Ramp Plus purchase orders using cursor pagination.

Tool for listing reimbursements with comprehensive filtering options. Returns reimbursement details including amounts, status, sync information, and associated entities. Use this to analyze reimbursement patterns, track approval workflows, and manage expense reimbursements.

Tool for listing all statements with filtering options. Perfect for financial reporting and reconciliation workflows.

Tool for listing users in your Ramp organization with flexible filtering. Perfect for user audits, access management, and organizational analysis. Helps identify inactive users, role distribution, and departmental structures.

Tool for listing vendors with their spending information. Returns vendor details including spending totals, categories, and activity status. Use this to analyze vendor relationships and procurement patterns.

Tool for listing bank accounts associated with a specific vendor. Returns account details including currency, payment method, and default status. Use this to retrieve payment account information for vendor transactions.

Tool for listing contacts associated with a specific vendor. Returns contact information including names, emails, and phone numbers. Use this to find vendor contact details for communication or relationship management.

Tool to list all vendor credits for all vendors of a business. Use when you need to track vendor credits, analyze credit usage across vendors, or reconcile vendor accounts.

Tool for listing all webhook subscriptions for the organization. Returns webhook details including endpoint URLs, event types, and status. Use this to audit webhook configurations and monitor active subscriptions.

Tool for listing options for a given accounting field.

Tool to update an accounting connection's settings. Use when you need to modify configuration for API-based accounting connections. This endpoint is restricted to Accounting API based connections only.

Tool to update a card's properties including owner, display name, and spending restrictions. Use when you need to modify card settings or reassign card ownership.

Tool to update a custom accounting field option. Use when you need to modify display name, code, value, or visibility of an existing field option.

Tool to update a general ledger account in Ramp. Use when you need to modify the name, code, or reactivate a deleted GL account.

Tool to update the inventory item accounting field for a Ramp connection. Use when you need to modify the name or display name of the inventory item field.

Tool to batch upload general ledger accounts to Ramp. Supports up to 500 accounts per call with all-or-nothing validation. Use when you need to create GL accounts in Ramp's accounting system.

Tool to register a new API-based accounting connection between Ramp and an accounting provider. Use when establishing a new connection to accounting systems like QuickBooks, NetSuite, or Xero. If a Universal CSV connection exists, it will be upgraded to an API-based connection.

Tool to batch upload vendors to Ramp for coding transactions, bills, and purchase orders. Supports up to 500 vendors per call with all-or-nothing validation. Use when you need to create vendors in Ramp's accounting system.

Tool to upload inventory item options for an active inventory item accounting field. Use when you need to create inventory items in Ramp's accounting system.

Tool to create a physical card asynchronously. Returns a task ID which can be used to track the card creation status. Physical cards require fulfillment details with a shipping address. Use when a user needs a physical card for in-person transactions.

Tool to reactivate a previously unlinked accounting connection by changing its status back to linked. This preserves all previous accounting field configurations and settings. Use when you need to restore a disconnected accounting integration. The business must not have any other active accounting connections.

Tool to reactivate a suspended user in your Ramp organization. Use when you need to restore a user's access. Upon reactivation, users can log in to Ramp again, spend on their previously issued cards, and resume receiving Ramp notifications.

Beta: release a Ramp bill hold so payments can be scheduled again.

Beta: submit a Ramp draft bill and return the resulting standard bill.

Tool to upload a receipt for a reimbursement. Use when submitting receipts for out-of-pocket expenses. If reimbursement_id is provided, attaches the receipt to an existing reimbursement; otherwise creates a new draft reimbursement via OCR.

Tool to suspend a card by creating an async task that locks the card from use. Use when you need to temporarily disable a card. The suspension is revertable.

Tool to permanently terminate a Ramp card. This action creates an async task to terminate the card and is irreversible. Use when you need to permanently deactivate a card. The response contains a task ID that can be used to check the termination status.

Tool to update a custom accounting field. Use when you need to modify the display name, name, or splittable setting of an existing custom accounting field.

Tool to update an inventory item option in Ramp's accounting system. Use when you need to modify an existing inventory item option's details.

Tool to update tax code accounting field. Use when you need to modify the name or display name of the tax code field in Ramp's accounting system.

Tool to update a tax code option in Ramp. Use when you need to modify the name or associated tax rates of an existing tax code option.

Tool to update an accounting tax rate in Ramp. Use when you need to modify the name, rate percentage, or associated GL account for an existing tax rate.

Tool to update an accounting vendor in Ramp. Use when you need to modify vendor details such as name or code, or reactivate a deleted vendor.

Update an approved Ramp bill. Ramp rejects updates to bills that are not approved.

Tool for updating spending limits on a card. Note: This returns the limits associated with the card. The actual update might require using the limit ID directly via PATCH /limits/{limit_id}.

Tool for updating an existing department in your Ramp organization. Useful for reorganizing departmental structure or renaming departments.

Beta: update only explicitly supplied fields on a Ramp draft bill.

Tool to update a spending limit in Ramp. Use when you need to modify limit settings such as display name, spending restrictions, permitted spend types, or user assignments.

Update an approved Ramp Plus purchase order; unapproved orders are rejected by Ramp.

Update one line item on an approved Ramp Plus purchase order.

Tool to update an existing user in your Ramp organization. Use when modifying user information such as name, department, role, or manager assignments.

Upload an invoice or supporting file to an existing Ramp bill.

Upload an invoice or supporting file to an existing Ramp draft bill.

Tool for uploading new options for a given accounting field.

Tool to upload tax code options to Ramp. Use when you need to create or update tax codes in the accounting system. Requires an active tax code accounting field for the accounting connection.

Tool to batch upload tax rates to Ramp. Supports up to 500 tax rates per call with all-or-nothing validation. Use when you need to create tax rates in Ramp's accounting system. Ensure data is sanitized and tax rates do not already exist before uploading.