Ramp corporate card and spend management. Use when user asks about expenses, transactions, cards, spend analysis, burn rate, or corporate finance. Triggers on ramp, expenses, transactions, spend, corporate card, burn rate.
name ramp description Ramp corporate card and spend management. Use when user asks about expenses, transactions, cards, spend analysis, burn rate, or corporate finance. Triggers on ramp, expenses, transactions, spend, corporate card, burn rate. version 1.0.0 tags ["ramp","finance","integration","expenses"] Ramp Corporate spend management via Ramp API. No OAuth needed — API key auth. Setup User needs a Ramp API key from their Ramp dashboard (Settings > Developer API). Store locally (default): mkdir -p ~/.atris/secrets/ramp read -s -p "Ramp API key: " key printf '%s' " $key "
~/.atris/secrets/ramp/API_KEY chmod 600 ~/.atris/secrets/ramp/API_KEY unset key echo "Saved." The key is available at runtime as RAMP_API_KEY env var. API Reference Base URL: https://api.ramp.com/developer/v1 Auth header: Authorization: Bearer $RAMP_API_KEY All responses are JSON. List endpoints support start (cursor) and page_size params for pagination. Transactions List Transactions curl -s "https://api.ramp.com/developer/v1/transactions?page_size=50" -H "Authorization: Bearer $RAMP_API_KEY " Filter params: from_date / to_date — ISO 8601 (e.g. 2026-03-01 ) department_id — filter by department merchant_id — filter by merchant user_id — filter by cardholder min_amount / max_amount — in cents state — PENDING, CLEARED, DECLINED Get Transaction curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Cards List Cards curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Get Card curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Create Virtual Card curl -s -X POST "" -H "Authorization: Bearer $RAMP_API_KEY " -H "Content-Type: application/json" -d '{ "display_name": "Marketing Q1", "user_id": "USER_ID", "spending_restrictions": { "amount": 500000, "interval": "MONTHLY", "lock_date": null, "categories": [] } }' Update Card (limits, name, owner) curl -s -X PATCH "" -H "Authorization: Bearer $RAMP_API_KEY " -H "Content-Type: application/json" -d '{ "display_name": "New Name", "spending_restrictions": {"amount": 100000, "interval": "MONTHLY"} }' Suspend Card curl -s -X POST "" -H "Authorization: Bearer $RAMP_API_KEY " -H "Content-Type: application/json" -d '{}' Terminate Card curl -s -X POST "" -H "Authorization: Bearer $RAMP_API_KEY " -H "Content-Type: application/json" -d '{}' Company Get Company Info curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Get Company Balance curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Users List Users curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Get User curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Departments List Departments curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Create Department curl -s -X POST "" -H "Authorization: Bearer $RAMP_API_KEY " -H "Content-Type: application/json" -d '{"name": "Engineering"}' Bills List Bills curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Create Bill curl -s -X POST "" -H "Authorization: Bearer $RAMP_API_KEY " -H "Content-Type: application/json" -d '{ "amount": {"amount": 150000, "currency_code": "USD"}, "vendor_name": "AWS", "invoice_number": "INV-001", "due_date": "2026-04-01", "memo": "March hosting" }' Reimbursements List Reimbursements curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Cashbacks List Cashback Payments curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Accounting List GL Accounts curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " List Vendors curl -s "" -H "Authorization: Bearer $RAMP_API_KEY " Workflows "What are we spending on?" Pull transactions: GET /transactions?from_date=2026-03-01&to_date=2026-03-31 Group by merchant name Sort by total amount descending Report top 10 merchants and total spend "Monthly burn rate" Pull transactions for last 3 months Sum cleared transactions per month Calculate average monthly spend Get company balance: GET /business/balance Runway = balance / average_monthly_burn "Subscription audit" Pull 90 days of transactions Find recurring merchants (same merchant, similar amounts, monthly cadence) Flag: unused (no logins), duplicate (overlapping tools), expensive (>$500/mo) Report with recommendation per subscription "Create a project card" Find the user: GET /users → match by name/email Confirm with user: "Create virtual card 'Project X' with $5,000/mo limit for {user}?" Create card: POST /cards/deferred/virtual Return card details "Department spend breakdown" List departments: GET /departments For each department, pull transactions filtered by department_id Summarize spend per department Highlight departments over/under budget "Anomaly detection" Pull last 30 days of transactions Calculate per-merchant averages from prior 90 days Flag transactions >2x the merchant average Flag new merchants with spend >$500 Flag weekend/holiday transactions Report anomalies with context Amounts All monetary amounts in the Ramp API are in cents (integer). $150.00 = 15000. Pagination List endpoints return { "data": [...], "page": { "next": "cursor_string" } } . To get next page: add ?start=cursor_string to the request. Rate Limits Ramp applies rate limits per API key. If you get 429, wait and retry with exponential backoff. Full API Spec For the complete OpenAPI spec: For AI-readable docs: