Ramp - Lava Documentation

Corporate card and spend-management API for reading transactions, bills, vendors, cards, and reimbursements, and for creating/updating spend programs, limits, and accounting records on a Ramp business. Best when an agent needs to query or act on a company’s actual card and AP activity. Unlike accounting APIs (QuickBooks, Xero), Ramp is the system of record for the underlying card swipes and bill payments themselves. 18 example endpoints available through Lava’s AI Gateway. See the Ramp API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://api.ramp.com/developer/v1 is supported. Any Ramp Developer API endpoint. Construct URL as https://api.ramp.com/developer/v1/{path}. Card lifecycle actions (freeze/unfreeze/terminate) are POSTs to /cards/{card_id}/deferred/{suspension|unsuspension|termination} with a { “idempotency_key”: ”…” } body — each returns a deferred task you poll at GET /cards/deferred/status/{task_id}. PATCH /cards/{card_id} only edits display name, owner, and spending limits; it has NO state field, and a card’s state and spending_restrictions.suspended are read-only (returned by GET, rejected on write). See https://docs.ramp.com/developer-api/v1 for the full reference. The endpoints below are curated examples.

Endpoints

List card transactions. Supports synced_after/from_date/to_date filters and pagination.

GET https://api.ramp.com/developer/v1/transactions?page_size=100 — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/transactions?page_size=100', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Ftransactions%3Fpage_size%3D100" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List bills (accounts payable).

GET https://api.ramp.com/developer/v1/bills?page_size=100 — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/bills?page_size=100', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fbills%3Fpage_size%3D100" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create an approved bill and select the payment method (ACH, check, wire, SWIFT, or Ramp card) in one call. Bills created via the API skip the draft phase. Resolve vendor_id, vendor_contact_id, entity_id, and source_bank_account_id from the entities/vendors endpoints first.

POST https://api.ramp.com/developer/v1/bills — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/bills', {
  body: {
"vendor_id": "{vendor_id}",
"vendor_contact_id": "{vendor_contact_id}",
"entity_id": "{entity_id}",
"invoice_number": "INV-2026-001",
"invoice_currency": "USD",
"issued_at": "2026-05-15",
"due_at": "2026-06-15",
"payment_method": "ACH",
"payment_details": {
  "payment_arrival_date": "2026-06-15",
  "source_bank_account_id": "{source_bank_account_id}",
  "vendor_account_id": "{vendor_account_id}"
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fbills" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vendor_id":"{vendor_id}","vendor_contact_id":"{vendor_contact_id}","entity_id":"{entity_id}","invoice_number":"INV-2026-001","invoice_currency":"USD","issued_at":"2026-05-15","due_at":"2026-06-15","payment_method":"ACH","payment_details":{"payment_arrival_date":"2026-06-15","source_bank_account_id":"{source_bank_account_id}","vendor_account_id":"{vendor_account_id}"}}'

List physical and virtual cards.

GET https://api.ramp.com/developer/v1/cards?page_size=100 — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/cards?page_size=100', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fcards%3Fpage_size%3D100" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a virtual card for a user with a spending limit.

POST https://api.ramp.com/developer/v1/cards/deferred/virtual — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/cards/deferred/virtual', {
  body: {
"display_name": "Vendor X subscription",
"user_id": "{user_id}",
"spending_restrictions": {
  "amount": 50000,
  "interval": "MONTHLY"
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fcards%2Fdeferred%2Fvirtual" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"display_name":"Vendor X subscription","user_id":"{user_id}","spending_restrictions":{"amount":50000,"interval":"MONTHLY"}}'

List vendors on the Ramp business.

GET https://api.ramp.com/developer/v1/vendors?page_size=100 — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/vendors?page_size=100', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fvendors%3Fpage_size%3D100" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a vendor on the Ramp business. Requires country and at least one contact (business_vendor_contacts, whose email is mandatory).

POST https://api.ramp.com/developer/v1/vendors — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/vendors', {
  body: {
"name": "Acme Supplies",
"country": "US",
"business_vendor_contacts": {
  "email": "ap@acme.com"
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fvendors" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Supplies","country":"US","business_vendor_contacts":{"email":"ap@acme.com"}}'

Update an existing vendor — accounting fields, country/state, description, or is_active (to deactivate). There is no name field on update.

PATCH https://api.ramp.com/developer/v1/vendors/{vendor_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/vendors/{vendor_id}', { method: 'PATCH', body: {"is_active":false} });

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fvendors%2F%7Bvendor_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_active":false}'

List vendor credits (credit memos) for the business. Read-only: Ramp exposes vendor credits for reading only — there is NO API to create or upload a vendor credit. Vendor credits are issued in the Ramp UI from a paid bill and synced to accounting.

GET https://api.ramp.com/developer/v1/vendors/credits?page_size=100 — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/vendors/credits?page_size=100', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fvendors%2Fcredits%3Fpage_size%3D100" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List employee reimbursement requests.

GET https://api.ramp.com/developer/v1/reimbursements?page_size=100 — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/reimbursements?page_size=100', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Freimbursements%3Fpage_size%3D100" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List users on the Ramp business.

GET https://api.ramp.com/developer/v1/users?page_size=100 — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/users?page_size=100', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fusers%3Fpage_size%3D100" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Get the connected Ramp business profile.

GET https://api.ramp.com/developer/v1/business — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/business', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fbusiness" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List spend programs on the Ramp business.

GET https://api.ramp.com/developer/v1/spend-programs?page_size=100 — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/spend-programs?page_size=100', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fspend-programs%3Fpage_size%3D100" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Edit a card: display name, owner (new_user_id), entity, notification settings, and spending limits. This endpoint does NOT freeze a card — it has no state field, and spending_restrictions.suspended and the card’s state are read-only (returned by GET, rejected on write with DEVELOPER_7001). To freeze, unfreeze, or terminate a card use the deferred actions below; setting spending_restrictions.amount to 0 caps the limit but does not block new charges.

PATCH https://api.ramp.com/developer/v1/cards/{card_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/cards/{card_id}', {
  method: 'PATCH',
  body: {
"display_name": "Marketing tools",
"spending_restrictions": {
  "amount": 100000,
  "interval": "MONTHLY"
}
},
});

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fcards%2F%7Bcard_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"display_name":"Marketing tools","spending_restrictions":{"amount":100000,"interval":"MONTHLY"}}'

Freeze (suspend) a card — the only way to block new charges. This is NOT a PATCH field and NOT part of spending_restrictions. The action is asynchronous: it returns a deferred task id; poll GET /cards/deferred/status/{task_id} to confirm the card reached the SUSPENDED state. Reverse with the unsuspension endpoint.

POST https://api.ramp.com/developer/v1/cards/{card_id}/deferred/suspension — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/cards/{card_id}/deferred/suspension', { body: {"idempotency_key":"00000000-0000-0000-0000-000000000000"} });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fcards%2F%7Bcard_id%7D%2Fdeferred%2Fsuspension" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotency_key":"00000000-0000-0000-0000-000000000000"}'

Unfreeze (unsuspend) a previously suspended card, restoring it to ACTIVE. Asynchronous — returns a deferred task id; poll GET /cards/deferred/status/{task_id} to confirm.

POST https://api.ramp.com/developer/v1/cards/{card_id}/deferred/unsuspension — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/cards/{card_id}/deferred/unsuspension', { body: {"idempotency_key":"00000000-0000-0000-0000-000000000000"} });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fcards%2F%7Bcard_id%7D%2Fdeferred%2Funsuspension" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotency_key":"00000000-0000-0000-0000-000000000000"}'

Permanently terminate a card. This is IRREVERSIBLE — unlike suspension, a terminated card cannot be reactivated. Asynchronous — returns a deferred task id; poll GET /cards/deferred/status/{task_id} to confirm.

POST https://api.ramp.com/developer/v1/cards/{card_id}/deferred/termination — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/cards/{card_id}/deferred/termination', { body: {"idempotency_key":"00000000-0000-0000-0000-000000000000"} });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fcards%2F%7Bcard_id%7D%2Fdeferred%2Ftermination" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotency_key":"00000000-0000-0000-0000-000000000000"}'

Poll the result of a deferred card action. Every card mutation (suspension, unsuspension, termination, and virtual/physical card creation) returns a task id rather than completing inline; fetch this until the task reports success and exposes the resulting card.

GET https://api.ramp.com/developer/v1/cards/deferred/status/{task_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.ramp.com/developer/v1/cards/deferred/status/{task_id}', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.ramp.com%2Fdeveloper%2Fv1%2Fcards%2Fdeferred%2Fstatus%2F%7Btask_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Next Steps

All Providers

Browse all supported AI providers

Forward Proxy

Learn how to construct proxy URLs and authenticate requests

⌘I

​Endpoints

​List card transactions. Supports synced_after/from_date/to_date filters and pagination.

​List bills (accounts payable).

​Create an approved bill and select the payment method (ACH, check, wire, SWIFT, or Ramp card) in one call. Bills created via the API skip the draft phase. Resolve vendor_id, vendor_contact_id, entity_id, and source_bank_account_id from the entities/vendors endpoints first.

​List physical and virtual cards.

​Create a virtual card for a user with a spending limit.

​List vendors on the Ramp business.

​Create a vendor on the Ramp business. Requires country and at least one contact (business_vendor_contacts, whose email is mandatory).

​Update an existing vendor — accounting fields, country/state, description, or is_active (to deactivate). There is no name field on update.

​List vendor credits (credit memos) for the business. Read-only: Ramp exposes vendor credits for reading only — there is NO API to create or upload a vendor credit. Vendor credits are issued in the Ramp UI from a paid bill and synced to accounting.

​List employee reimbursement requests.

​List users on the Ramp business.

​Get the connected Ramp business profile.

​List spend programs on the Ramp business.

​Unfreeze (unsuspend) a previously suspended card, restoring it to ACTIVE. Asynchronous — returns a deferred task id; poll GET /cards/deferred/status/{task_id} to confirm.

​Permanently terminate a card. This is IRREVERSIBLE — unlike suspension, a terminated card cannot be reactivated. Asynchronous — returns a deferred task id; poll GET /cards/deferred/status/{task_id} to confirm.

​Poll the result of a deferred card action. Every card mutation (suspension, unsuspension, termination, and virtual/physical card creation) returns a task id rather than completing inline; fetch this until the task reports success and exposes the resulting card.

​Next Steps

All Providers

Forward Proxy

Endpoints

List card transactions. Supports synced_after/from_date/to_date filters and pagination.

List bills (accounts payable).

Create an approved bill and select the payment method (ACH, check, wire, SWIFT, or Ramp card) in one call. Bills created via the API skip the draft phase. Resolve vendor_id, vendor_contact_id, entity_id, and source_bank_account_id from the entities/vendors endpoints first.

List physical and virtual cards.

Create a virtual card for a user with a spending limit.

List vendors on the Ramp business.

Create a vendor on the Ramp business. Requires country and at least one contact (business_vendor_contacts, whose email is mandatory).

Update an existing vendor — accounting fields, country/state, description, or is_active (to deactivate). There is no name field on update.

List vendor credits (credit memos) for the business. Read-only: Ramp exposes vendor credits for reading only — there is NO API to create or upload a vendor credit. Vendor credits are issued in the Ramp UI from a paid bill and synced to accounting.

List employee reimbursement requests.

List users on the Ramp business.

Get the connected Ramp business profile.

List spend programs on the Ramp business.

Unfreeze (unsuspend) a previously suspended card, restoring it to ACTIVE. Asynchronous — returns a deferred task id; poll GET /cards/deferred/status/{task_id} to confirm.

Permanently terminate a card. This is IRREVERSIBLE — unlike suspension, a terminated card cannot be reactivated. Asynchronous — returns a deferred task id; poll GET /cards/deferred/status/{task_id} to confirm.

Poll the result of a deferred card action. Every card mutation (suspension, unsuspension, termination, and virtual/physical card creation) returns a task id rather than completing inline; fetch this until the task reports success and exposes the resulting card.

Next Steps