Ramp

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.

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.

11 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}. 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

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

cURL

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

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

cURL

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

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

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

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

cURL

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

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

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

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

cURL

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"

List employee reimbursement requests.

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

SDK

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

cURL

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

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

cURL

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

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

cURL

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

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

cURL

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"

Update a card (display name, owner, spending restrictions, notification settings).

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

SDK

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

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"}}'

Next Steps

All Providers

Browse all supported AI providers

Forward Proxy

Learn how to construct proxy URLs and authenticate requests