Obtain a Ramp API access token via the OAuth 2.0 client credentials flow using your client_id and client_secret against the Ramp token endpoint.
GET https://api.ramp.com/developer/v1/transactions with Authorization: Bearer YOUR_TOKEN to retrieve the list of transactions.
Use query parameters such as from_date and to_date (ISO 8601 format) to filter by date range, and department_id or user_id to narrow results.
The response contains a data array of transaction objects; each includes fields such as amount, merchant_name, card_holder_name, sk_category_name, and accounting_field_selections.
Implement cursor-based pagination using the next query parameter returned in the response page info block.
For GL-ready exports, use the accounting_field_selections on each transaction which reflect the coding applied by cardholders or accountants in Ramp.
Known gotchas
Ramp access tokens are short-lived; implement token refresh or re-issuance logic before each batch export to avoid mid-export authentication failures.
Transactions in 'PENDING' state may not yet have final amounts; filter for 'CLEARED' transactions for accounting exports to avoid posting provisional amounts.
The Ramp API uses cursor-based pagination, not offset-based; do not attempt to skip pages using an offset parameter.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp