Quickstart

In your Ramp account, go to Company → Developer. Admin access is required.

1. Click Create New App.
2. Name your app, for example API Quickstart, and accept the Terms.
3. Under Grant types, click Add new grant type and select Client Credentials.
4. Under Scopes, click Configure allowed scopes and select transactions:read.
5. Copy your Client ID and Client Secret.

Store both securely. You need them in the next step, and the secret is shown once.

Ramp authenticates the token request with HTTP Basic Auth: base64-encode client_id:client_secret and send it in the Authorization header.

curl -X POST https://api.ramp.com/developer/v1/token \
  -H "Authorization: Basic $(echo -n 'YOUR_CLIENT_ID:YOUR_CLIENT_SECRET' | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "scope=transactions:read"

The response carries the token you will send on every later call.

{
  "access_token": "YOUR_ACCESS_TOKEN",
  "token_type": "Bearer",
  "expires_in": 864000,
  "scope": "transactions:read"
}

Client credentials tokens live for 10 days. Authorization Code and Refresh Token flows issue one-hour tokens instead — see Authorization.

Send the token as a bearer credential.

curl https://api.ramp.com/developer/v1/transactions \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

You get a page of transactions plus a next cursor when more results exist. Follow that cursor to walk the full set — see Conventions for the pagination contract.