Ramp

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.