# Ramp MCP connector

Connect Ramp to Claude, ChatGPT, Cursor and any MCP client through Elaichi, so your finance team can review and update Ramp's chart of accounts, accounting connections and field options in plain language, with every change logged.

Source: https://elaichi.ai/connectors/ramp/

## Facts

| | |
| --- | --- |
| Application | Ramp |
| Category | Spend Management |
| AI tools | 246 |
| Authentication | Connects over OAuth |
| Needs your own OAuth app | Yes |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. 246 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Ramp is connected

- Summarize last week's Ramp transactions by accounting account.
- Which Ramp cards spent most this month?
- List Ramp accounting connections added since April.

## Connect Ramp in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Ramp.
2. Optionally set Share with, then press Connect.
3. Supply your own Ramp app, then approve. Ramp needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Ramp tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Ramp to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Ramp to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Ramp to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Ramp to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Ramp tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Ramp through Elaichi

### Keep the chart of accounts current

Accounting. When a new general ledger account is opened in the ERP, add the matching accounting account in Ramp and fix the name or code on an existing one without opening the settings screen.

### Tidy up departments, locations and classes

Finance. List every accounting field option in Ramp, spot duplicates and stale entries, and rename or retire them so cardholders stop picking the wrong one.

### Limit which options cardholders can choose

Controllers. Set filter rules on Ramp accounting fields so a team only sees the departments or cost centers that apply to it, and clear out old rules in bulk when the structure changes.

### Check on the accounting connection

Finance systems. Ask which accounting connections Ramp has, whether one needs reactivating, and mark a connection ready to migrate when the company moves to a new ledger.

### Code spend to the right account

Accounting. Create an accounting coding in Ramp that ties spend to the correct account, department and class ahead of the close, instead of fixing it after the export.

### Stand up a new entity's accounting setup

Operations. Create the accounting entity in Ramp for a newly acquired company, then add its accounts and field options so its spend is coded properly from the first month.

## Frequently asked questions

### How do I connect Ramp to Claude?

Two steps. First connect Ramp in Elaichi: Ramp connects over OAuth, but it needs an OAuth application you register inside Ramp yourself, so somebody with admin rights brings a client ID and secret once, and after that everyone signs in with their own Ramp login. Then in Claude open Customize, then Connectors, then Add, and paste the endpoint https://api.elaichi.ai/mcp. Nobody else on the team handles a credential from that point on.

### Does Ramp work with ChatGPT and Cursor as well as Claude?

Yes. Once Ramp is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect Ramp once and every client picks it up.

### What can an AI agent actually do with my Ramp data?

With Ramp connected, you can ask for a list of your accounting accounts, add or rename one, review the department, location and class options cardholders pick from, set rules for which options each team sees, create accounting codings, and check on or reactivate your accounting connections. Ramp exposes a lot of actions, so short concrete asks work best, such as "list our Ramp accounting field options" rather than a long paragraph.

### Does connecting Ramp give the AI everything in my Ramp account?

No. Every request to Ramp runs as the person who signed in, so the AI can only see and change what that person's own Ramp role already allows. Elaichi can narrow that further, for example to read-only on the chart of accounts, but it can never grant more than the person has in Ramp.

### Can my team share one Ramp connection?

Yes. One person connects Ramp in Elaichi and shares it with a team, and nobody else ever sees the client ID, secret or any token. Each teammate still signs in as themselves, so the audit log records who changed which accounting account or field option in Ramp.

### Can I stop an agent from deleting or changing things in Ramp?

Yes. Restrictions in Elaichi work per action, so you can allow listing Ramp accounting accounts while blocking deletes, updates or bulk removals of field options. A blocked action is never shown to Claude, ChatGPT or Cursor at all, so no prompt, however worded, can reach it.

### What happens to a Ramp connection when someone leaves?

When you offboard someone in Elaichi, their access to Ramp through every AI client ends at once. If they had shared a Ramp connection with the team, it keeps working for everyone else. Disconnecting Ramp once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client together.

## All 246 Ramp tools

Every tool below is callable through https://api.elaichi.ai/mcp once Ramp is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all Ramp accounting accounts** (List). List general ledger accounts in Ramp with optional filters by remote_id, code, active status, and accounting connection. Returns: accounting_connection_id, classification, code, created_at, entity_remote_ids, gl_account_category_info, id, is_active, name, provider_name, ramp_id, updated_at, visibility, remote_id, is_synced. If the account belongs to an inactive accounting connection,…
- **Create a Ramp accounting account** (Create). Upload general ledger accounts. Returns: accounting_connection_id, gl_accounts, uploaded. Required: gl_accounts.
- **Get single Ramp accounting account by ID** (Get). Get a single Ramp general ledger account by id. Returns: accounting_connection_id, classification, code, created_at, entity_remote_ids, gl_account_category_info, id, is_active, name, provider_name, ramp_id, updated_at, visibility, remote_id, is_synced. If the account belongs to an inactive accounting connection, supply accounting_connection_id to retrieve it. Required: id.
- **Update a Ramp accounting account by ID** (Update). Update the name or code of a general ledger account in Ramp. Returns: accounting_connection_id, classification, code, created_at, entity_remote_ids, gl_account_category_info, id, is_active, name, provider_name, ramp_id, updated_at, visibility, remote_id, is_synced. Required: id.
- **Delete a Ramp accounting account by ID** (Delete). Delete a general ledger account in Ramp by id. Returns an empty 204 response on success. Required: id.
- **List all Ramp accounting all connections** (List). List all accounting connections for the current business in Ramp, including both active and inactive connections. Returns a list of accounting connection records with their id and provider details. No required parameters. This endpoint replaces the deprecated /accounting/connection endpoint.
- **Create a Ramp accounting coding** (Create). Post accounting coding selections to a Ramp object such as a transaction or bill. Returns the created accounting coding object on success (201). Requires a JSON request body specifying the coding selections to apply. Required: accounting_coding_selections, object_id, object_type.
- **List all Ramp accounting connections** (List). Fetch the current active accounting connection in Ramp. Deprecated — use the all-connections endpoint instead. Returns: id. May return an empty response when no active connection exists.
- **Create a Ramp accounting connection** (Create). Register a new API-based accounting connection in Ramp. If a Universal CSV connection already exists, it will be upgraded to an API-based connection. Returns: connection_type, created_at, id, is_active, is_ready_to_migrate, last_linked_at, remote_provider_name, settings, status. A JSON request body is required. Required: remote_provider_name.
- **Get single Ramp accounting connection by ID** (Get). Get a specific Ramp accounting connection by id. Returns: connection_type, created_at, id, is_active, is_ready_to_migrate, last_linked_at, remote_provider_name, settings, status. Required: id.
- **Update a Ramp accounting connection by ID** (Update). Update an accounting connection in Ramp by id. Returns: connection_type, created_at, id, is_active, is_ready_to_migrate, last_linked_at, remote_provider_name, settings, status. Restricted to Accounting API based connections. A JSON request body is required. Required: id.
- **Ramp accounting connections bulk delete** (Delete). Disconnect an API-based accounting connection in Ramp. Only API-based connections can be disconnected through this endpoint. Returns an empty 204 response on success.
- **Create a Ramp reactivate** (Create). Reactivate a previously unlinked Ramp accounting connection, changing its status back to linked while preserving previous field configurations and settings. Returns: connection_type, created_at, id, is_active, is_ready_to_migrate, last_linked_at, remote_provider_name, settings, status. The business must not have any other active accounting connections. Required: connection_id.
- **Create a Ramp ready to migrate** (Create). Mark an inactive Ramp accounting connection as ready to migrate, making it available in the ERP migration flow UI. Returns the updated accounting connection (AccountingProvider) object including its id. There must be a separate active accounting connection the customer will migrate away from. Required: connection_id.
- **Create a Ramp accounting entity** (Create). Upload accounting entities to Ramp in an all-or-nothing batch of up to 500. Returns a 201 success response confirming the uploaded entities. Requires a JSON request body. Required: entities.
- **List all Ramp accounting field option filter rules** (List). List Ramp field option filter rules that define which target field options are available based on selected trigger field options. Returns: required_selections, target_field_option_remote_id, target_field_remote_id, id, accounting_connection_id.
- **Create a Ramp accounting field option filter rule** (Create). Bulk create Ramp field option filter rules that define which target field options are available based on selected trigger field options. Multiple rules for the same target option use OR logic; multiple required_selections within a rule use AND logic. Returns a bulk operation response. Required: rules.
- **Ramp accounting field option filter rules bulk delete** (Delete). Bulk delete Ramp field option filter rules by specifying rules identified by their target option and required selections. Rules that don't exist are counted as duplicates (no-op). Returns a bulk operation response. Required: rules.
- **List all Ramp accounting field options** (List). List options for a given custom Ramp accounting field, filterable by remote_id, is_active, code, visibility, and accounting_connection_id. Returns the custom accounting field option records. Required: field_id.
- **Create a Ramp accounting field option** (Create). Upload up to 500 new field options for a custom accounting field in Ramp as an all-or-nothing batch; if any option is malformed or already exists, the entire batch is rejected. Returns the upload result. Max 500 options per batch. Required: field_id, options.
- **Get single Ramp accounting field option by ID** (Get). Get a custom accounting field option in Ramp by id. Returns the custom accounting field option object. If the option belongs to an inactive accounting connection, accounting_connection_id must also be supplied. Required: id.
- **Update a Ramp accounting field option by ID** (Update). Update a custom accounting field option in Ramp by id. Returns the updated custom accounting field option object. Required: id.
- **Delete a Ramp accounting field option by ID** (Delete). Delete a custom accounting field option in Ramp by id. Returns an empty 204 response on success. Required: id.
- **Ramp accounting field options partial update** (Update). Partially update a custom accounting field option in Ramp. Returns the updated option including id, field_id, remote_id, is_active, code, visibility, and accounting_connection_id. Required: id.
- **List all Ramp accounting fields** (List). List custom accounting fields in Ramp, filterable by remote_id, is_active, and accounting_connection_id. Returns: accounting_connection_id, created_at, display_name, id, input_type, is_active, is_required_for, is_splittable, name, provider_name, ramp_id, updated_at, remote_id. Max 100 per page.
- **Create a Ramp accounting field** (Create). Create a new custom accounting field in Ramp. If a field with the same id already exists, the existing field is returned instead (and reactivated if it was inactive). Returns: accounting_connection_id, created_at, display_name, id, input_type, is_active, is_required_for, is_splittable, name, provider_name, ramp_id, updated_at, remote_id. Required: id, input_type, name.
- **Get single Ramp accounting field by ID** (Get). Get a single custom accounting field in Ramp by id. Returns: accounting_connection_id, created_at, display_name, id, input_type, is_active, is_required_for, is_splittable, name, provider_name, ramp_id, updated_at, remote_id. Required: id.
- **Update a Ramp accounting field by ID** (Update). Update a custom accounting field in Ramp by id. Returns: accounting_connection_id, created_at, display_name, id, input_type, is_active, is_required_for, is_splittable, name, provider_name, ramp_id, updated_at, remote_id. Required: id.
- **Delete a Ramp accounting field by ID** (Delete). Delete a custom accounting field in Ramp by id. Returns an empty 204 response on success. Required: id.
- **List all Ramp accounting inventory items** (List). Fetch the Ramp inventory item accounting field for the current accounting connection. Returns: accounting_connection_id, display_name, id, name, ramp_id, created_at, updated_at.
- **Create a Ramp accounting inventory item** (Create). Create a new inventory item accounting field in Ramp. There can only be one active inventory item accounting field per accounting connection. Returns: accounting_connection_id, display_name, id, name, ramp_id, created_at, updated_at. Required: name.
- **Ramp accounting inventory items bulk update** (Update). Update the inventory item accounting field for the current Ramp accounting connection. Returns: accounting_connection_id, display_name, id, name, ramp_id, created_at, updated_at.
- **Ramp accounting inventory items bulk delete** (Delete). Delete the inventory item accounting field for a Ramp accounting connection. Returns an empty 204 response on success.
- **List all Ramp inventory item options** (List). List inventory item options. Returns: accounting_connection_id, entity_remote_ids, gl_account_id, id, is_active, name, ramp_id.
- **Create a Ramp inventory item option** (Create). Upload inventory item options in Ramp. There must be an active inventory item accounting field for the accounting connection. Returns the uploaded inventory item options including id, code, remote_id, is_active, and is_synced. Required: options.
- **Update a Ramp inventory item option by ID** (Update). Update a Ramp inventory item option by id. Returns the updated option including id, remote_id, code, is_active, is_synced, and accounting_connection_id. Required: id.
- **Delete a Ramp inventory item option by ID** (Delete). Delete a Ramp inventory item option by id. The request body must include accounting_connection_id when the option belongs to an inactive accounting connection. Returns an empty 204 response on success. Required: id.
- **Create a Ramp accounting Ramp field option** (Create). Upload new options for a Ramp-only accounting field in Ramp. Returns: accounting_connection_id, options, uploaded, field_id. Required: accounting_connection_id, field_id, options.
- **Update a Ramp accounting Ramp field option by ID** (Update). Update a Ramp-only field option in Ramp by id. Returns: accounting_connection_id, code, created_at, display_name, entity_remote_ids, id, is_active, provider_name, ramp_id, updated_at, value, visibility, remote_id, field_id. Required: id, accounting_connection_id.
- **Delete a Ramp accounting Ramp field option by ID** (Delete). Delete a Ramp-only field option in Ramp by id. Returns an empty 204 response on success. Required: id, accounting_connection_id.
- **List all Ramp accounting Ramp fields** (List). List Ramp-only accounting fields with optional filters by remote ID, active status, and accounting connection. Returns: accounting_connection_id, created_at, display_name, id, input_type, is_active, is_required_for, is_splittable, name, provider_name, ramp_id, updated_at, remote_id.
- **Create a Ramp accounting Ramp field** (Create). Create a Ramp-only accounting field in Ramp. Returns: accounting_connection_id, created_at, display_name, id, input_type, is_active, is_required_for, is_splittable, name, provider_name, ramp_id, updated_at, remote_id. Required: id, input_type, name.
- **Get single Ramp accounting Ramp field by ID** (Get). Get a single Ramp-only accounting field by id. Returns: accounting_connection_id, created_at, display_name, id, input_type, is_active, is_required_for, is_splittable, name, provider_name, ramp_id, updated_at, remote_id. If the field belongs to an inactive accounting connection, supply accounting_connection_id. Required: id.
- **Update a Ramp accounting Ramp field by ID** (Update). Update a Ramp-only accounting field by id. Returns: accounting_connection_id, created_at, display_name, id, input_type, is_active, is_required_for, is_splittable, name, provider_name, ramp_id, updated_at, remote_id. Required: id.
- **Delete a Ramp accounting Ramp field by ID** (Delete). Delete a Ramp-only accounting field by id. Returns an empty 204 response on success. Required: id.
- **Create a Ramp accounting ready to sync** (Create). Mark Ramp objects (such as transactions) as ready to sync to your connected accounting provider (ERP), flagging them as reviewed and complete for inclusion in the next accounting sync. Returns an empty 204 response on success. Required: object_ids, object_type.
- **Create a Ramp accounting sync** (Create). Notify Ramp of a list of accounting sync results by posting sync statuses. Returns the synced object confirming receipt. An idempotency key is required to ensure that subsequent requests are properly handled. Required: idempotency_key, sync_type.
- **List all Ramp tax codes** (List). Fetch the tax code accounting field for the current Ramp accounting connection. Returns: accounting_connection_id, display_name, id, name, ramp_id. This endpoint returns a single resource, not a paginated list.
- **Create a Ramp tax code** (Create). Create a new tax code accounting field in Ramp. Only one active tax code field is allowed per accounting connection. Returns: accounting_connection_id, display_name, id, name, ramp_id. Required: name.
- **Ramp tax codes bulk update** (Update). Update the tax code accounting field for the current Ramp accounting connection. Returns: accounting_connection_id, display_name, id, name, ramp_id.
- **Ramp tax codes bulk delete** (Delete). Delete the tax code accounting field for a Ramp accounting connection. Returns an empty 204 response on success.
- **List all Ramp code options** (List). List Ramp tax code options, filterable by code, active status, sync status, remote ID, and accounting connection. Returns: accounting_connection_id, entity_remote_ids, id, is_active, name, ramp_id, tax_rate_ids, code, remote_id, is_synced. Max 100 per page.
- **Create a Ramp code option** (Create). Upload tax code options to Ramp for an active tax code accounting field. Returns the created tax code options including id, code, and remote_id. There must be an active tax code accounting field for the accounting connection. Required: options.
- **Update a Ramp code option by ID** (Update). Update a Ramp tax code option by id. Returns the updated tax code option including id, code, is_active, and accounting_connection_id. Required: id.
- **Delete a Ramp code option by ID** (Delete). Delete a Ramp tax code option by id. Returns an empty 204 response on success. Required: id.
- **List all Ramp tax rates** (List). List Ramp accounting tax rates. Returns: accounting_connection_id, accounting_gl_account_id, id, name, ramp_id, rate. Specify accounting_connection_id when the tax rate belongs to an inactive accounting connection. Max 100 per page.
- **Create a Ramp tax rate** (Create). Upload up to 500 tax rates to Ramp in an all-or-nothing batch. Returns: accounting_connection_id, tax_rates, id. If any rate in the batch is malformed or violates a constraint, the entire batch is disregarded. Required: tax_rates.
- **Update a Ramp tax rate by ID** (Update). Update a Ramp tax rate by id. Returns: accounting_connection_id, accounting_gl_account_id, id, name, ramp_id, rate. Required: id.
- **Delete a Ramp tax rate by ID** (Delete). Delete a Ramp tax rate by id. Returns an empty 204 response on success. Required: id.
- **List all Ramp accounting vendors** (List). List accounting vendors in Ramp with optional filters by remote_id, is_active, code, is_synced, and accounting_connection_id. Returns: accounting_connection_id, code, created_at, entity_remote_ids, id, is_active, is_synced, name, provider_name, ramp_id, updated_at, vendor_category_info, remote_id. Page size must be between 2 and 100 (defaults to 20).
- **Create a Ramp accounting vendor** (Create). Upload vendors. Returns: uploaded, vendors. Required: vendors.
- **Get single Ramp accounting vendor by ID** (Get). Get a specific Ramp accounting vendor by id. Returns: accounting_connection_id, code, created_at, entity_remote_ids, id, is_active, is_synced, name, provider_name, ramp_id, updated_at, vendor_category_info, remote_id. If the vendor belongs to an inactive accounting connection, pass accounting_connection_id to retrieve it. Required: id.
- **Update a Ramp accounting vendor by ID** (Update). Update a Ramp accounting vendor by id. Returns: accounting_connection_id, code, created_at, entity_remote_ids, id, is_active, is_synced, name, provider_name, ramp_id, updated_at, vendor_category_info, remote_id. Required: id.
- **Delete a Ramp accounting vendor by ID** (Delete). Delete a Ramp accounting vendor by id. Returns an empty 204 response on success. A JSON request body is required; include accounting_connection_id when the vendor belongs to an inactive accounting connection. Required: id.
- **List all Ramp developer applications** (List). Fetch the active financing application for a Ramp business. Returns a single application object per the ApiApplicationResource schema (field definitions not enumerated in available documentation). Each business can only have one active financing application, so the endpoint always returns a single record. No required parameters.
- **Create a Ramp developer application** (Create). Create a Ramp financing application for an applicant, creating a new business and emailing sign-up instructions. Returns an undocumented 2XX success response. If the email already exists, an invitation is re-sent when the business is in the application stage; if already approved, the operation is a no-op. Required: applicant.
- **List all Ramp audit logs events** (List). List Ramp audit log events with optional filters by user, date range, event type, actor type, or referenced object. Returns: id, created_at, business_id. Page size must be between 2 and 100 (defaults to 20).
- **List all Ramp developer bank accounts** (List). List Ramp bank accounts, optionally filtered by connection provider. Returns: account_name, account_number_last_four, account_subtype, connection_provider, financial_institution_name, id. Max 100 per page.
- **Get single Ramp developer bank account by ID** (Get). Get a single Ramp bank account by id. Returns: account_name, account_number_last_four, account_subtype, connection_provider, financial_institution_name, id. Required: id.
- **List all Ramp banking accounts** (List). List all banking accounts for the business in Ramp, including checking, brokerage, and investment accounts. Returns: account_type, id, name, display_name.
- **List all Ramp account balance histories** (List). List daily available balance snapshots for a Ramp banking account. Returns: amount, date. Results can be filtered to a specific date range using ISO 8601 formatted start and end dates. Required: account_id.
- **List all Ramp banking syncable transactions** (List). List syncable banking transactions in Ramp available for syncing to an accounting provider. Returns: amount, date, description, destination_account_name, entity_id, id, source_account_name, sync_status, treasury_transfer_type. Requires an active accounting provider connection. Max 100 per page.
- **List all Ramp developer bills** (List). List Ramp bills with filters by vendor, entity, approval/payment/sync status, payment method, date ranges, and amount. Returns the bill object including id, vendor_id, invoice_number, amount, due_at, issued_at, payment_method, payment_status, sync_status, created_at, line_items, and accounting_field_selections.
- **Create a Ramp developer bill** (Create). Create a bill in Ramp from a draft bill. Batch payments cannot be created in the API. Returns the created bill including id, vendor_id, invoice_number, amount, due_at, issued_at, payment_method, payment_status, sync_status, created_at, line_items, and accounting_field_selections. Required: due_at, entity_id, invoice_currency, invoice_number, issued_at, vendor_id.
- **Get single Ramp developer bill by ID** (Get). Fetch a single Ramp bill by id. Returns the bill object including id, vendor_id, invoice_number, amount, due_at, issued_at, payment_method, payment_status, sync_status, created_at, line_items, and accounting_field_selections. Required: id.
- **Update a Ramp developer bill by ID** (Update). Update an approved bill in Ramp. Only approved bills can be updated. Returns the updated bill object including id, invoice_number, vendor_id, entity_id, amount, due_at, issued_at, payment_method, payment_status, approval_status, status_summary, and created_at. Required: id.
- **Delete a Ramp developer bill by ID** (Delete). Archive a bill in Ramp. This is a destructive action — associated inflight payments will be cancelled and any attached one-time-card will be terminated. Paid bills and bills belonging to a batch payment cannot be deleted. Returns an empty 204 response on success. Required: id.
- **Ramp developer bills attach** (Action). Upload a file attachment to an existing Ramp bill. INVOICE type attachments cannot be uploaded if one already exists on the bill. Returns: id, type, created_at, business_id, object. Required: bill_id.
- **List all Ramp bills drafts** (List). List draft bills in Ramp with optional filters by entity, vendor, invoice number, remote ID, and date ranges. Returns: accounting_date, accounting_field_selections, amount, bill_owner, created_at, due_at, entity_id, id, inventory_line_items, invoice_number, invoice_urls, issued_at, line_items, memo, posting_date, remote_id, status, sync_status, vendor, vendor_memo, vendor_id.
- **Create a Ramp bills draft** (Create). Create a new draft bill in Ramp. Returns: accounting_date, accounting_field_selections, amount, bill_owner, created_at, due_at, entity_id, id, inventory_line_items, invoice_number, invoice_urls, issued_at, line_items, memo, posting_date, remote_id, status, sync_status, vendor, vendor_memo, vendor_id. Required: vendor_id.
- **Get single Ramp bills draft by ID** (Get). Get a single Ramp draft bill by id. Returns: accounting_date, accounting_field_selections, amount, bill_owner, created_at, due_at, entity_id, id, inventory_line_items, invoice_number, invoice_urls, issued_at, line_items, memo, posting_date, remote_id, status, sync_status, vendor, vendor_memo, vendor_id. Required: id.
- **Update a Ramp bills draft by ID** (Update). Update an existing Ramp draft bill by id. Returns: accounting_date, accounting_field_selections, amount, bill_owner, created_at, due_at, entity_id, id, inventory_line_items, invoice_number, invoice_urls, issued_at, line_items, memo, posting_date, remote_id, status, sync_status, vendor, vendor_memo, vendor_id. Required: id.
- **Ramp bills drafts attach** (Action). Upload a file attachment to an existing Ramp draft bill. INVOICE type attachments cannot be uploaded if one already exists on the draft bill. Returns: id, type, created_at, business_id, object. Required: draft_bill_id.
- **Create a Ramp bill hold** (Create). Place a hold on a Ramp bill, blocking all payment rails and descheduling pending payments. Returns the updated Bill object including id, vendor_id, payment_status, amount, and created_at. Required: bill_id.
- **Create a Ramp bill release** (Create). Release a bill hold in Ramp, allowing payments to be scheduled on the bill. Returns the Bill object including id, vendor_id, invoice_number, amount, approval_status, and payment_status. Required: bill_id.
- **List all Ramp bill remittance receipts** (List). Download a Ramp bill remittance receipt as a PDF file. Returns the receipt as a binary PDF (content-type: application/pdf). Required: bill_id.
- **Create a Ramp blank canvas approvals document** (Create). Upload a document for a Ramp blank canvas approval workflow step using multipart/form-data. The document is sent as an attachment part and metadata as form-data parts. Returns an empty 204 response on success.
- **Create a Ramp developer blank canvas approval** (Create). Approve or reject a Ramp blank canvas workflow step by submitting a decision for the given approval trigger instance. Returns a success response from the BlankCanvasApprovalResponse schema confirming the workflow step decision. Required: blank_canvas_approval_id, action.
- **Ramp blank canvas approval metadata bulk update** (Update). Update metadata for a blank canvas external approval request in Ramp. Returns the blank canvas approval metadata resource. Required: approval_trigger_instance_id.
- **List all Ramp developer busineses** (List). Get the Ramp business (company) information for the current authenticated business. Returns the Business object including id. The full field set is referenced as #/components/schemas/Business upstream; consult the Ramp API reference for the complete property breakdown.
- **List all Ramp business balances** (List). Fetch the company balance information from Ramp. Returns the BusinessBalance object containing the company's current balance details.
- **List all Ramp cards physicals** (List). List physical cards in Ramp, filterable by owner, display name, activation status, and termination status. Returns: automatic_routing_enabled, cardholder_id, cardholder_name, created_at, display_name, expiration, fulfillment, fund_id, has_program_overridden, id, is_physical, is_primary, is_suspended, last_four, state, user_id. Page size between 2 and 100, defaults to 20.
- **Create a Ramp cards physical** (Create). Create a new physical card in Ramp. Returns: automatic_routing_enabled, cardholder_id, cardholder_name, created_at, display_name, expiration, fulfillment, fund_id, has_program_overridden, id, is_physical, is_primary, is_suspended, last_four, state, user_id. Required: shipping_address, user_id.
- **Get single Ramp cards physical by ID** (Get). Get a single Ramp physical card by id. Returns: automatic_routing_enabled, cardholder_id, cardholder_name, created_at, display_name, expiration, fulfillment, fund_id, has_program_overridden, id, is_physical, is_primary, is_suspended, last_four, state, user_id. Required: id.
- **Update a Ramp cards physical by ID** (Update). Update a Ramp physical card by id. Returns: automatic_routing_enabled, cardholder_id, cardholder_name, created_at, display_name, expiration, fulfillment, fund_id, has_program_overridden, id, is_physical, is_primary, is_suspended, last_four, state, user_id. Required: id.
- **Delete a Ramp cards physical by ID** (Delete). Terminate a Ramp physical card by id. This action is irreversible. Returns an empty 204 response on success. Required: id.
- **Create a Ramp suspension** (Create). Suspend a physical Ramp card by card_id. The suspension is revertable and can be undone via the unsuspend endpoint. Returns the PhysicalCard object including id, display_name, and user_id. Required: card_id.
- **Ramp suspensions bulk delete** (Delete). Unsuspend a Ramp physical card, removing its suspended state. Returns the updated PhysicalCard object including id, display_name, and user_id. Required: card_id.
- **Create a Ramp cards vault** (Create). Create a spend limit and retrieve sensitive card details in Ramp. Returns the created PCI limit object including its id. Required: user_id.
- **Get single Ramp cards vault by ID** (Get). Get a Ramp card's sensitive details by id. Returns the card details object including its id. Required: id.
- **List all Ramp cards virtuals** (List). List virtual cards for a Ramp business, filterable by business entity, card owner, and termination status. Returns: created_at, fund_id, id, is_card_suspended, user_id. Page size must be between 2 and 100.
- **Get single Ramp cards virtual by ID** (Get). Fetch a virtual card. Returns: created_at, fund_id, id, is_card_suspended, user_id. Required: id.
- **List all Ramp developer cashbacks** (List). List Ramp cashback payments with optional filters by sync status, business entity, statement, and date range. Returns: amount, created_at, entity_id, id, sync_status. Max 100 per page.
- **Get single Ramp developer cashback by ID** (Get). Get a single Ramp cashback payment by id. Returns: amount, created_at, entity_id, id, sync_status. Required: id.
- **List all Ramp developer comments** (List). List comments on a Ramp object's discussion thread, paginated by keyset cursor. Returns: created_at, id, message, user_id, updated_at. Required: object_id, object_type.
- **Create a Ramp developer comment** (Create). Create a comment on a Ramp object's discussion thread. Returns the created comment including id, created_at, and updated_at. Required: object_id, object_type, message.
- **Get single Ramp collections response by ID** (Get). Get a single Ramp custom form collection response by id. Returns: custom_form_collection_response, id. Required: id.
- **Create a Ramp configure custom table** (Create). Create a custom table in Ramp for storing custom record data. Returns an empty 200 response on success. Required: table_label, table_name.
- **Create a Ramp custom table column** (Create). Create Custom Table column. Returns: column_id. Required: custom_table_name.
- **Update a Ramp custom table column by ID** (Update). Change the API name of a Custom Table's Column. Required: id, custom_table_name, new_name.
- **List all Ramp custom table columns** (List). List Custom Table columns. Returns: allows_writes, display_name, id, name, type. Required: custom_table_name.
- **Create a Ramp configure native table** (Create). Extend a Native Ramp table in Ramp by submitting a JSON request body identifying the table to configure. Returns a 200 response confirming the table extension. Required: table_name.
- **Create a Ramp native table column** (Create). Create a new custom column for a Native Ramp table in Ramp. Returns the created column object including its id. Required: native_table_name.
- **Update a Ramp native table column by ID** (Update). Change the API name of a Native Ramp table's custom record column in Ramp. Returns an empty 204 response on success. Required: id, native_table_name, new_name.
- **List all Ramp native table columns** (List). List custom columns for a Native Ramp table in Ramp. Returns each column with its id. Required: native_table_name.
- **List all Ramp custom records custom tables** (List). List all Custom Tables available for the Ramp business. Returns each table reference including id, label, and name. No required parameters.
- **List all Ramp custom table rows** (List). List rows from a Ramp Custom Table by custom_table_name. Returns: cells, display_name, external_key, id. Max 100 rows per page. Required: custom_table_name.
- **Delete a Ramp custom table row by ID** (Delete). Delete rows from a Ramp Custom Table by custom_table_name. Returns: metadata. Required: custom_table_name, data.
- **Ramp custom table rows partial update** (Update). Change the external key of a single Ramp Custom Table row. Returns an empty 204 response on success. Required: id, custom_table_name, new_external_key.
- **Create a Ramp custom table row** (Create). Append cells to rows in a Ramp Custom Table by table_name. Returns: metadata. Required: table_name, data.
- **Ramp custom table rows bulk delete** (Delete). Remove cells from a Custom Table. Returns: metadata. Required: table_name, data.
- **Ramp custom table rows bulk update** (Update). Set values for rows in a Ramp Custom Table by custom_table_name. Returns: metadata. Required: custom_table_name, data.
- **List all Ramp custom records matrix tables** (List). List all Matrix tables for the business in Ramp. Matrix tables are special-purpose lookup tables where unique combinations of input values map to result values. Returns a list of matrix tables including their id and name. No required parameters.
- **Create a Ramp custom records matrix table** (Create). Create a Matrix table. Returns: table_id. Required: input_columns, label, result_columns.
- **Create a Ramp matrix table column** (Create). Add a result column to an existing Ramp Matrix table. Returns the created result column. Only result columns (users and accounting_field_options) can be added; input columns cannot be added after table creation. Required: table_name, cardinality, label, native_table.
- **Update a Ramp matrix table column by ID** (Update). Change the API name of a Ramp Matrix table column (input or result) while preserving the human-readable label. Returns an empty 204 response on success. Required: id, table_name, new_name.
- **Create a Ramp matrix table list row** (Create). List rows from a Ramp Matrix table by table name, returning each row with inputs and results separated. Inputs are always complete (all input columns), while results are sparse (only set values). Returns: id, inputs, results. Required: table_name.
- **Create a Ramp matrix table rename** (Create). Change the API name of a Matrix table in Ramp. Returns an empty 204 response on success. The request body is required but its field definitions are not enumerated in the available OpenAPI spec. Required: table_name, new_name.
- **Delete a Ramp matrix table row by ID** (Delete). Delete a single Ramp matrix table row by id. Returns an empty 204 response on success. Required: id, table_name.
- **Create a Ramp matrix table row** (Create). Append cells to Ramp matrix table rows by adding values to many-to-many result columns without replacing existing values. Only works on many-to-many result columns. Set ignore_duplicates=true to skip existing duplicate cells instead of erroring. Returns: metadata. Required: table_name, data.
- **Ramp matrix table rows bulk delete** (Delete). Remove specific values from many-to-many result columns of Ramp matrix table rows without affecting other values. Returns: metadata. Required: table_name, data.
- **Ramp matrix table rows bulk update** (Update). Upsert (create or update) Ramp matrix table rows by table name. Row identity is defined by external_key within the input values, and result values can be partially updated. Returns: metadata. Required: table_name, data.
- **List all Ramp custom records native tables** (List). List Native Ramp tables available for custom records. Returns: table_name, type.
- **List all Ramp native table rows** (List). List custom column values for rows of a Native Ramp table in Ramp. Returns: cells, display_name, external_key, id. Filter by ramp_id to retrieve rows for specific Ramp objects; max 100 rows per page. Required: native_table_name.
- **Create a Ramp native table row** (Create). Append cells to a Native Ramp table in Ramp. Returns: metadata. Required: native_table_name, data.
- **Delete a Ramp native table row by ID** (Delete). Remove cells from a Native Ramp table in Ramp. Returns: metadata. Required: native_table_name, data.
- **Ramp native table rows bulk update** (Update). Set values for rows of a Native Ramp table in Ramp. Returns: metadata. Required: native_table_name, data.
- **List all Ramp developer departments** (List). List departments in Ramp with cursor-based pagination. Returns: id, name. Page size must be between 2 and 100, defaulting to 20.
- **Create a Ramp developer department** (Create). Create a new department in Ramp. Returns the created department object including its id. Requires a JSON request body with department details. Required: name.
- **Get single Ramp developer department by ID** (Get). Fetch a department. Returns: id, name. Required: id.
- **Update a Ramp developer department by ID** (Update). Update a Ramp department by id. Returns the updated department object including its id. Required: id, name.
- **Create a Ramp card embed** (Create). Create an embed init token for a Ramp card to initialize Ramp Embedded. Returns the embed initialization response (Ramp Embedded Initialized). The specified card must be activated and currently active. Required: card_id, parent_origin.
- **List all Ramp developer entities** (List). List business entities in Ramp, filterable by currency, name, and primary status. Returns: accounts, connected_subsidiary, currency, custom_record_fields, default_bill_pay_payment_account_id, entity_name, id, is_primary, location_ids, payment_accounts. Results are paginated; max 100 per page, defaults to 20.
- **Get single Ramp developer entity by ID** (Get). Get a single business entity in Ramp by id. Returns: accounts, connected_subsidiary, currency, custom_record_fields, default_bill_pay_payment_account_id, entity_name, id, is_primary, location_ids, payment_accounts. Required: id.
- **List all Ramp developer funds** (List). List Ramp funds with optional filters by display name, spend program, entity, card, user, termination status, and member roles. Returns: balance, cards, created_at, display_name, entity_id, id, is_exempt_from_policy_agent, is_shareable, members, overrides_spend_program, permitted_spend_types, spend_program_id, spending_restrictions, state, suspension, user_id, is_terminated. Max 100 per page.
- **Create a Ramp developer fund** (Create). Create a Ramp fund either with a spend_program_id (inherits program defaults) or standalone (must provide display_name, spending_restrictions, and permitted_spend_types). Returns: balance, cards, created_at, display_name, entity_id, id, is_exempt_from_policy_agent, is_shareable, members, overrides_spend_program, permitted_spend_types, spend_program_id, spending_restrictions, state, suspension,…. Required: user_id.
- **Get single Ramp developer fund by ID** (Get). Get a single Ramp fund by id. Returns: balance, cards, created_at, display_name, entity_id, id, is_exempt_from_policy_agent, is_shareable, members, overrides_spend_program, permitted_spend_types, spend_program_id, spending_restrictions, state, suspension, user_id, is_terminated. Required: id.
- **Update a Ramp developer fund by ID** (Update). Update a Ramp fund by id. Returns: balance, cards, created_at, display_name, entity_id, id, is_exempt_from_policy_agent, is_shareable, members, overrides_spend_program, permitted_spend_types, spend_program_id, spending_restrictions, state, suspension, user_id, is_terminated. Required: id.
- **Delete a Ramp developer fund by ID** (Delete). Terminate a Ramp fund by id. Returns: balance, cards, created_at, display_name, entity_id, id, is_exempt_from_policy_agent, is_shareable, members, overrides_spend_program, permitted_spend_types, spend_program_id, spending_restrictions, state, suspension, user_id, is_terminated. Required: id.
- **Create a Ramp member suspension** (Create). Suspend a fund member in Ramp. Returns the updated Fund object including id, display_name, spend_program_id, entity_id, is_terminated, and created_at. Required: fund_id, user_id.
- **Ramp member suspensions bulk delete** (Delete). Unsuspend a fund member in Ramp. Returns the updated Fund object including id, display_name, spend_program_id, entity_id, is_terminated, and created_at. Required: fund_id, user_id.
- **Create a Ramp fund suspension** (Create). Suspend a fund in Ramp. Returns the Fund object including its id and schema-specific attributes. Required: fund_id.
- **Ramp fund suspensions bulk delete** (Delete). Unsuspend a fund in Ramp, reversing a prior suspension. Returns the Fund object including its id and schema-specific attributes. Required: fund_id.
- **List all Ramp developer item receipts** (List). List item receipts in Ramp with optional filters by entity, purchase order, or purchase order line item. Returns: archived_at, created_at, documents, id, item_receipt_number, line_items, memo, purchase_order_id, received_at, remote_id, entity_id, purchase_order_line_item_id. Archived receipts are excluded by default; set include_archived to true to include them.
- **Create a Ramp developer item receipt** (Create). Create an item receipt in Ramp associated with a purchase order. Returns the created item receipt including id, entity_id, and purchase_order_id. Required: item_receipt_line_items, item_receipt_number, purchase_order_id, received_at.
- **Get single Ramp developer item receipt by ID** (Get). Get a single Ramp item receipt by id. Returns: archived_at, created_at, documents, id, item_receipt_number, line_items, memo, purchase_order_id, received_at, remote_id, entity_id, purchase_order_line_item_id. Required: id.
- **Delete a Ramp developer item receipt by ID** (Delete). Delete an item receipt in Ramp by id. Returns an empty 204 response on success. Required: id.
- **List all Ramp developer locations** (List). List Ramp locations, optionally filtered by associated business entity. Returns: entity_id, id, name. Page size must be between 2 and 100; defaults to 20.
- **Create a Ramp developer location** (Create). Create a new location in Ramp. Returns the created Location object including its id. The request body is required and its fields are defined by the Ramp ApiLocationCreateRequestBody schema. Required: name.
- **Get single Ramp developer location by ID** (Get). Get a single Ramp location by id. Returns: entity_id, id, name. Required: id.
- **Update a Ramp developer location by ID** (Update). Update a Ramp location by id with a JSON request body. Returns: entity_id, id, name. The request body fields are defined by the Ramp ApiLocationUpdateRequestBody schema. Required: id, name.
- **List all Ramp developer memos** (List). List transaction memos in Ramp with optional filters by card, department, location, manager, merchant, user, and date range. Returns: id, memo, transaction_id, created_at, updated_at.
- **Get single Ramp developer memo by ID** (Get). Get a single transaction memo in Ramp by id. Returns: id, memo, transaction_id, created_at, updated_at. Required: id.
- **Create a Ramp developer memo** (Create). Upload a new memo for a Ramp transaction. Returns: id, memo, transaction_id, created_at, updated_at. Required: memo_id, memo.
- **List all Ramp developer merchants** (List). List merchants. Returns: id, is_auto_approved, merchant_name, sk_category_name.
- **List all Ramp developer purchase orders** (List). List Ramp purchase orders with optional filters by creation source, date range, external ID, remote ID, receipt status, entity, spend request, and three-way match status. Returns: accounting_field_selections, amount, archived_at, bill_ids, billing_status, created_at, creation_source, entity_id, external_id, id, item_receipt_ids, line_items, memo, name, net_payment_terms, owner_id, promise_date,…
- **Create a Ramp developer purchase order** (Create). Create a new Ramp purchase order. Returns the created purchase order including id, creation_source, created_at, external_id, receipt_status, entity_id, three_way_match_enabled. Required: currency, entity_id, line_items, three_way_match_enabled.
- **Get single Ramp developer purchase order by ID** (Get). Get a single Ramp purchase order by id. Returns: accounting_field_selections, amount, archived_at, bill_ids, billing_status, created_at, creation_source, custom_form_collection_response, entity_id, external_id, id, item_receipt_ids, line_items, memo, name, net_payment_terms, owner_id, promise_date, purchase_order_number, ramp_url, receipt_status, remote_id, ship_to_address, ship_to_company_name,…. Required: id.
- **Update a Ramp developer purchase order by ID** (Update). Update an approved Ramp purchase order by id. Returns the updated purchase order including id, creation_source, created_at, external_id, receipt_status, entity_id, three_way_match_enabled. The purchase order must be approved. Required: id.
- **Ramp developer purchase orders archive** (Archive). Archive a Ramp purchase order by purchase_order_id. Returns an empty 204 response on success. Required: purchase_order_id.
- **Create a Ramp purchase order line item** (Create). Add line items to an existing Ramp purchase order. Returns the updated purchase order detail including id, created_at, creation_source, and receipt_status. Required: purchase_order_id, line_items.
- **Update a Ramp purchase order line item by ID** (Update). Update a single line item on an existing Ramp purchase order. The purchase order must be approved. Returns the updated purchase order detail including id, created_at, creation_source, and receipt_status. Required: id, purchase_order_id.
- **Delete a Ramp purchase order line item by ID** (Delete). Delete a single line item from an approved Ramp purchase order. Returns the updated purchase order detail including id, created_at, creation_source, and receipt_status. The purchase order must be approved. Required: id, purchase_order_id.
- **List all Ramp receipt integrations opt outs** (List). List emails opted out of Ramp receipt integrations. Returns: email, id.
- **Create a Ramp receipt integrations opt out** (Create). Add a new email to the Ramp receipt integrations opt-out list. Returns: email, id. Required: business_id, email.
- **Delete a Ramp receipt integrations opt out by ID** (Delete). Remove an email from the Ramp receipt integration opt-out list, opting it back in to receipt integrations. Returns an empty 204 response on success. Required: id.
- **List all Ramp developer receipts** (List). List Ramp receipts with optional filters by creation date, transaction, or reimbursement. Returns: created_at, id, ocr, receipt_url, reimbursement_id, transaction_id, user_id, user_transaction_time. Page size must be between 2 and 100.
- **Create a Ramp developer receipt** (Create). Upload a receipt image to Ramp, optionally associating it with a transaction. If no transaction_id is provided, Ramp auto-matches the receipt to the most relevant transaction. Returns: id, created_at. Required: idempotency_key, user_id.
- **Get single Ramp developer receipt by ID** (Get). Get a single Ramp receipt by id. Returns: created_at, id, ocr, receipt_url, reimbursement_id, transaction_id, user_id, user_transaction_time. Required: id.
- **List all Ramp developer reimbursements** (List). List Ramp reimbursements with filters for state, direction, sync status, date ranges, user, entity, and approval. Returns: accounting_date, accounting_field_selections, approved_at, attendees, created_at, direction, distance, employee_id, end_location, entity_amount, entity_id, fund_id, id, line_items, memo, merchant, merchant_amount, merchant_id, payee_amount, payment_batch_id, payment_id,…
- **Get single Ramp developer reimbursement by ID** (Get). Get a single Ramp reimbursement by id. Returns: accounting_date, accounting_field_selections, approved_at, attendees, created_at, direction, distance, employee_id, end_location, entity_amount, entity_id, fund_id, id, line_items, memo, merchant, merchant_amount, merchant_id, payee_amount, payment_batch_id, payment_id, payment_processed_at, receipts, spend_limit_id, start_location, state,…. Required: id.
- **Create a Ramp reimbursements mileage** (Create). Create a mileage reimbursement in Ramp. Returns the created reimbursement object including its id, state, and user_id. A JSON request body is required. Required: distance, reimbursee_id, trip_date.
- **Create a Ramp reimbursements submit receipt** (Create). Upload a receipt to create or link a Ramp reimbursement. When reimbursement_id is supplied the receipt links to that reimbursement; otherwise Ramp creates a draft reimbursement via OCR. Returns: accounting_date, accounting_field_selections, approved_at, attendees, created_at, direction, distance, employee_id, end_location, entity_amount, entity_id, fund_id, id, line_items, memo, merchant,…. Required: idempotency_key, reimbursee_id.
- **List all Ramp developer repayments** (List). List Ramp repayments ordered by creation date in descending order. Returns: entity_id, funding_method, id, original_transaction_id, repaid_at, repayment_amount, status, user_id, user_signature, created_at. Entity_id filtering is not yet supported.
- **List all Ramp developer spend programs** (List). List spend programs in Ramp with paginated results. Returns: description, display_name, icon, id, is_shareable, issue_physical_card_if_needed, permitted_spend_types, restrictions, spending_restrictions. Max 100 per page.
- **Create a Ramp developer spend program** (Create). Create a spend program in Ramp. Returns: description, display_name, icon, id, is_shareable, issue_physical_card_if_needed, permitted_spend_types, restrictions, spending_restrictions. Required: description, display_name, icon, permitted_spend_types, spending_restrictions.
- **Get single Ramp developer spend program by ID** (Get). Get a single Ramp spend program by id. Returns the spend program detail object including id, display_name, and spending_restrictions. Required: id.
- **List all Ramp spend program workflow nodes** (List). List External Approval Request workflow nodes for a Ramp spend program, filtered by the external approval integration key configured on each node. Returns: workflow_nodes. Required: spend_program_id, service_key.
- **Create a Ramp spend requests draft via ocr** (Create). Create a draft spend request in Ramp by uploading a receipt or document image for OCR processing. Returns the created draft spend request including its id. A request body is required and must be sent as multipart/form-data. Required: idempotency_key, requester_user_id, spend_intent_id.
- **List all Ramp developer statements** (List). List Ramp statements with optional end_date range filtering. Returns: balance_sections, charges, credits, end_date, ending_balance, id, opening_balance, payments, preceding_statement_id, start_date, statement_lines, statement_url. Use from_date and to_date (ISO8601) to filter by the statement's end_date. Max 100 per page.
- **Get single Ramp developer statement by ID** (Get). Get a single Ramp statement by id. Returns: balance_sections, charges, credits, end_date, ending_balance, id, opening_balance, payments, preceding_statement_id, start_date, statement_lines, statement_url. Required: id.
- **Create a Ramp developer token** (Create). Create an OAuth 2.0 access token in Ramp using authorization_code, refresh_token, or client_credentials grant. Returns: access_token, expires_in, id_token, refresh_token, refresh_token_expires_in, scope, token_type. Required: grant_type.
- **Create a Ramp token revoke** (Create). Revoke a Ramp access or refresh token. Returns an empty 200 response on success. Required: token.
- **List all Ramp developer transactions** (List). List Ramp transactions with extensive filtering by category, department, user, card, state, amount range, sync status, and more. Returns: accounting_categories, accounting_date, accounting_field_selections, all_requirements_met_and_approved, amount, attendees, card_holder, card_id, card_present, currency_code, decline_details, disputes, entity_amount, entity_id, fund_id, id, limit_id, line_items,…
- **Get single Ramp developer transaction by ID** (Get). Get a single Ramp transaction by id. Returns: accounting_categories, accounting_date, accounting_field_selections, all_requirements_met_and_approved, amount, attendees, card_holder, card_id, card_present, currency_code, decline_details, disputes, entity_amount, entity_id, fund_id, id, limit_id, line_items, memo, merchant_amount, merchant_category_code, merchant_category_code_description,…. Required: id.
- **Update a Ramp developer transaction by ID** (Update). Split a Ramp transaction into line items or update an existing split by sending line_items with amounts in minor units that sum to the transaction amount. Returns: accounting_categories, accounting_date, accounting_field_selections, all_requirements_met_and_approved, amount, attendees, card_holder, card_id, card_present, currency_code, decline_details, disputes, entity_amount, entity_id, fund_id,…. Required: id.
- **List all Ramp developer transfers** (List). List Ramp transfer payments with optional filters by status, sync status, entity, statement, and date range. Returns: amount, bank_account_id, created_at, entity_id, id, payment_id, status, sync_status.
- **Get single Ramp developer transfer by ID** (Get). Get a single Ramp transfer payment by id. Returns: amount, bank_account_id, created_at, entity_id, id, payment_id, status, sync_status. Required: id.
- **List all Ramp developer trips** (List). List all Ramp trips for the business, filterable by user IDs, status, date range, amount, and trip name. Returns: id, name. Max 100 per page.
- **Get single Ramp developer trip by ID** (Get). Get a single Ramp trip by id. Returns: created_at, description, end_date, id, length_in_days, locations, name, spend_events, start_date, status, total_spend, total_spend_amount, travel_types, updated_at, user_id, amount. Required: id.
- **List all Ramp developer unified requests** (List). List Ramp unified requests with optional filters by department, entity, location, owner, spend program, type, status, and amount range. Returns: id, created_at. Page size 2–100. Response schema not finalized.
- **Get single Ramp developer unified request by ID** (Get). Get a single Ramp unified request by id. Returns: id, created_at. Response schema is not yet finalized and subject to breaking changes. Required: id.
- **List all Ramp developer users** (List). List Ramp users with optional filters by employee_id, role, status, entity, department, email, and location. Returns the user object including id and additional fields defined by the Ramp User schema. Max 100 per page.
- **Get single Ramp developer user by ID** (Get). Get a single Ramp user by id. Returns the user object including id and additional fields defined by the Ramp User schema. Required: id.
- **Update a Ramp developer user by ID** (Update). Update a Ramp user by id. Returns an empty 204 response on success. Required: id.
- **Ramp developer users invite** (Invite). Manage a Ramp draft user's invite lifecycle — schedule a future invitation, cancel a pending scheduled invitation, or send the invite immediately. The user must be in DRAFT status for SCHEDULE and SEND_NOW. Returns an empty object on success. Required: user_id, action.
- **Ramp developer users bulk update** (Update). Deactivate a Ramp user by user_id. Deactivated users can no longer log in, spend on cards, or receive Ramp notifications. Returns an empty object on success. Required: user_id.
- **Create a Ramp users deferred** (Create). Create a deferred user invite in Ramp, triggering an async task that emails an invitation the recipient must accept to be onboarded. Returns: id. The request body is required; specify location_id to assign the user to a specific entity. Required: email, first_name, idempotency_key, last_name, role.
- **Get single Ramp deferred status by ID** (Get). Fetch the status of a deferred Ramp user invite task by id. Returns: context, data, id, status. Required: id.
- **Ramp user reactivates bulk update** (Update). Reactivate a Ramp user so they can log in again, spend on previously issued cards, and resume receiving Ramp notifications. Returns an empty response body on success. Required: user_id.
- **Create a Ramp vault card** (Create). Create a spend limit and retrieve sensitive card details in Ramp. Returns: allowed_overage_percent_override, card, created_at, display_name, restrictions, spend_limit_id, spend_program_id, user_id. Requires a JSON request body. This endpoint is deprecated. Required: user_id.
- **Get single Ramp vault card by ID** (Get). Get a Ramp card's sensitive vault details by id. Returns the card's id and an attributes object containing sensitive card data (PAN, CVV). This endpoint is deprecated. Required: id.
- **List all Ramp developer vendors** (List). List vendors. Returns: accounting_vendor_remote_id, address, addresses, billing_frequency, contacts, country, created_at, default_entity_id.
- **Create a Ramp developer vendor** (Create). Create a new vendor. Returns: accounting_vendor_remote_id, address, addresses, billing_frequency, contacts, country, created_at, default_entity_id. Required: business_vendor_contacts, country.
- **Get single Ramp developer vendor by ID** (Get). Get a single Ramp vendor by id. Returns: accounting_vendor_remote_id, address, addresses, approval_status, billing_frequency, contacts, country, created_at, custom_form_collection_response, custom_record_fields, default_entity_id, default_payment_method, description, external_vendor_id, federal_tax_classification, id, is_active, is_deletable, merchant_id, name, name_legal, parent_vendor_id,…. Required: id.
- **Update a Ramp developer vendor by ID** (Update). Update a vendor. Returns: accounting_vendor_remote_id, address, addresses, billing_frequency, contacts, country, created_at, default_entity_id. Required: id.
- **Delete a Ramp developer vendor by ID** (Delete). Delete a Ramp vendor by id. Returns an empty 204 response on success. A vendor cannot be deleted if it has associated transactions, bills, contracts, spend requests, or child vendors. Required: id.
- **Create a Ramp vendors agreement** (Create). List Ramp vendor agreements by submitting a query request body. Returns: auto_renewal, available_actions, contract_owners, created_at, currency, custom_record_field_values, days_remaining, deleted_at, department, description, draft_spend_requests, end_date, has_approved_renewal_request, id, is_snoozed, is_up_for_renewal, last_date_to_terminate, latest_renewal_request, logo, name,…
- **Get single Ramp vendors agreement by ID** (Get). Get a single Ramp vendor agreement by id. Returns: archived_at, auto_renewal, available_actions, comment_thread_uuid, contract_owners, created_at, currency, custom_record_field_values, days_remaining, deleted_at, description, draft_spend_requests, end_date, has_approved_renewal_request, id, is_active, is_snoozed, is_up_for_renewal, last_date_to_terminate, latest_rejected_renewal_request,…. Required: id.
- **Update a Ramp vendors agreement by ID** (Update). Update a Ramp vendor agreement by id. Returns: archived_at, auto_renewal, available_actions, comment_thread_uuid, contract_owners, created_at, currency, custom_record_field_values, days_remaining, deleted_at, description, draft_spend_requests, end_date, has_approved_renewal_request, id, is_active, is_snoozed, is_up_for_renewal, last_date_to_terminate, latest_rejected_renewal_request, line_items,…. Required: id.
- **Delete a Ramp vendors agreement by ID** (Delete). Delete a Ramp vendor agreement by id. Returns an empty 204 response on success. Required: id.
- **Create a Ramp agreement document** (Create). Upload documents to a Ramp vendor agreement as multipart form-data, including each file as a repeated `documents` part. Returns: batch_id, document_count, job_id. An X-Idempotency-Key header must also be supplied. Required: agreement_id.
- **Create a Ramp agreement link** (Create). Link purchase orders or documents to a Ramp vendor agreement. Returns the link operation result object whose field-level schema is not enumerated in the discovered API reference. Required: agreement_id.
- **Create a Ramp agreement link spend request** (Create). Link a spend request to a Ramp vendor agreement. Returns: agreement, number_of_documents_linked, number_of_purchase_orders_linked. Required: agreement_id, source, spend_request_id.
- **Ramp agreement unlinks bulk delete** (Delete). Unlink purchase orders or documents from a Ramp vendor agreement. Returns a success response confirming the unlink operation. Required: agreement_id.
- **List all Ramp vendors credits** (List). List all Ramp vendor credits for a business, with optional filters by entity, created_at range, accounting date range, and fully-used status. Returns: id, created_at. Max 100 per page.
- **Get single Ramp vendors credit by ID** (Get). Get a single Ramp vendor credit by id. Returns: accounting_date, accounting_field_selections, applied_bills, applied_draft_bills, created_at, entity_id, expense_line_items, id, inventory_line_items, reference_bill_id, reference_number, remaining_amount, total_amount, total_applied_amount, vendor_id. Required: id.
- **List all Ramp vendor accounts** (List). List vendor bank accounts for a specific Ramp vendor. Returns: account_nickname, account_number_last_four, currency, id, is_default, payment_method. Required: vendor_id.
- **Ramp vendor accounts archive** (Archive). Archive a Ramp vendor bank account. If the bank account has associated bills, drafts, or recurring templates, a replacement_bank_account_id must be provided in the request body. Returns an empty 204 response on success. Required: bank_account_id, vendor_id.
- **Get single Ramp vendor account by ID** (Get). Get a Ramp vendor bank account by id. Returns: account_nickname, account_number_last_four, currency, id, is_default, payment_method. Required: id, vendor_id.
- **Create a Ramp vendor agreement** (Create). Create a vendor agreement for a specific Ramp vendor. Returns the created vendor agreement object. Required: vendor_id, auto_renewal, name, notifications_on, start_date, total_value.
- **List all Ramp vendor childrens** (List). List child vendors of a parent vendor. Returns: accounting_vendor_remote_id, address, addresses, billing_frequency, contacts, country, created_at, default_entity_id. Required: vendor_id.
- **List all Ramp vendor contacts** (List). List vendor contacts for a specific Ramp vendor. Returns the vendor contact object including id and contact-specific attributes defined upstream. Required: vendor_id.
- **Get single Ramp vendor contact by ID** (Get). Get a single Ramp vendor contact by id. Returns the vendor contact object including id and contact-specific attributes defined upstream. Required: id, vendor_id.
- **List all Ramp vendor credits** (List). List vendor credits for a specific Ramp vendor. Returns: id, created_at. Fully used credits are excluded by default. Required: vendor_id.
- **Create a Ramp vendor hold** (Create). Place a hold on a Ramp vendor to block payments. Open, unpaid bills that can still be modified are removed from scheduled payment flows. Returns an empty 204 response on success. Required: vendor_id.
- **Create a Ramp vendor release** (Create). Release the active vendor-scoped hold in Ramp, allowing new payments to be scheduled for the vendor. Payments removed while the hold was active must be re-scheduled afterward. Returns an empty 204 response on success. Required: vendor_id.
- **Create a Ramp vendor update bank account** (Create). Add payment details to a Ramp vendor's bank account through the approval workflow, supporting ACH (routing and account numbers), Wire (routing and account numbers), and Crypto (stablecoin wallet address and network) payment methods. The proposal may require approval depending on the business's approval policies. Returns the bank account update response. Required: vendor_id.
- **List all Ramp developer webhooks** (List). List all Ramp webhook subscriptions. Returns: business_id, created_at, endpoint_url, event_types, id, status, updated_at, type, object.
- **Create a Ramp developer webhook** (Create). Create a new Ramp webhook subscription. The subscription starts in a pending verification state and must be verified before receiving events. Returns: additional_headers, business_id, created_at, endpoint_url, event_types, id, secret, status, updated_at, type, object. Required: endpoint_url, event_types.
- **Get single Ramp developer webhook by ID** (Get). Get a single Ramp webhook subscription by id. Returns: business_id, created_at, endpoint_url, event_types, id, status, updated_at, type, object. Required: id.
- **Delete a Ramp developer webhook by ID** (Delete). Delete a Ramp webhook subscription by id. Returns an empty 204 response on success. Required: id.
- **Ramp developer webhooks verify** (Verify). Verify a pending Ramp webhook subscription by submitting the challenge string Ramp sent to your endpoint during setup. Returns: success. Required: webhook_id, challenge.
- **Create a Ramp webhooks mock webhook event** (Create). Create a mock Ramp webhook event delivered to active subscriptions matching the specified event type. Returns the event payload including id, type, created_at, business_id, and object. Required: event_type, object_id, object_metadata.
- **Create a Ramp fund member** (Create). Add members to a Ramp fund by fund_id. Returns the updated Fund object including id, display_name, members, and spend_program_id. Required: fund_id, user_ids.
- **Ramp fund members bulk delete** (Delete). Remove members from a Ramp fund by submitting their user IDs. Returns the updated fund object including id, display_name, entity_id, is_terminated, and members. This is a beta endpoint. Required: fund_id, user_ids.