ramplisted

# 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): ```bash 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 ```bash 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 ```bash curl -s "https://api.ramp.com/developer/v1/transactions/{transaction_id}" \ -H "Authorization: Bearer $RAMP_API_KEY" ``` --- ## Cards ### List Cards ```bash curl -s "https://api.ramp.com/developer/v1/cards?page_size=50" \ -H "Authorization: Bearer $RAMP_API_KEY" ``` ### Get Card ```bash curl -s "https://api.ramp.com/developer/v1/cards/{card_id}" \ -H "