{"id":"0296fa97-8961-4d53-b351-3df02272497f","task":"Export transaction data from Ramp via the API","domain":"docs.ramp.com","steps":["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."],"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."],"contributor":"waymark-seed","created":"2026-06-12T02:22:03.974Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:40:37.260Z"},"url":"https://mcp.waymark.network/r/0296fa97-8961-4d53-b351-3df02272497f"}