> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ramp

> Read Ramp corporate card transactions, cards, employees, and reimbursements for spend management

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0 (client credentials).
* **Connection**: Veryfront mints machine-to-machine tokens from the client ID and secret in the project's environment variables.
* **Docs**: [https://docs.ramp.com/developer-api/v1/authorization](https://docs.ramp.com/developer-api/v1/authorization)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable             | Required | Description                                                                                                                         |
| -------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `RAMP_CLIENT_ID`     | Yes      | Ramp developer app Client ID (Ramp dashboard → Company → Developer) [Docs](https://docs.ramp.com/developer-api/v1/getting-started). |
| `RAMP_CLIENT_SECRET` | Yes      | Ramp developer app Client Secret [Docs](https://docs.ramp.com/developer-api/v1/getting-started).                                    |

## Setup

1. **Get a Ramp account or sandbox**: Sign up at [https://ramp.com](https://ramp.com), or request Sandbox access from Ramp to build without a live account. The sandbox has the same API surface with test data: app at [https://demo.ramp.com](https://demo.ramp.com), API at [https://demo-api.ramp.com](https://demo-api.ramp.com).
2. **Create a developer app**: In the Ramp dashboard go to Company → Developer (admin access required) and click Create New App. Copy the Client ID and Client Secret.
3. **Enable the Client Credentials grant and scopes**: In the app settings, under Grant types add Client Credentials, then under Scopes configure the allowed scopes: transactions:read, cards:read, users:read, reimbursements:read.
4. **Set environment variables**: Add RAMP\_CLIENT\_ID and RAMP\_CLIENT\_SECRET to your .env.
5. **Verify access**: Run List Transactions. Access tokens are minted automatically from [https://api.ramp.com/developer/v1/token](https://api.ramp.com/developer/v1/token) using HTTP Basic auth with your client credentials; the requested scopes are sent in the token request.

* Sandbox and production require separate apps - create one app in each environment. This connector targets production (api.ramp.com); for sandbox testing point a copy at demo-api.ramp.com with sandbox app credentials.
* Scopes are configured on the app and requested at token time; only request the scopes you need.
* List endpoints paginate with a page.next cursor - pass the last item's ID as the start parameter for the next page.

Provider API reference: [https://docs.ramp.com/developer-api/v1/getting-started](https://docs.ramp.com/developer-api/v1/getting-started)

## Tools

| Tool                | Access | Description                                                                                      |
| ------------------- | ------ | ------------------------------------------------------------------------------------------------ |
| List Transactions   | Read   | List card transactions with optional filtering by state, user, card, or date window              |
| Get Transaction     | Read   | Fetch full details of a single card transaction                                                  |
| List Cards          | Read   | List corporate cards with optional filtering by owner or activation state                        |
| List Users          | Read   | List employees on the Ramp account with optional filtering by email, role, department, or status |
| Get User            | Read   | Fetch a single employee by ID, e.g. to resolve the user\_id referenced on a transaction or card  |
| Get Card            | Read   | Fetch a single corporate card by ID, e.g. to resolve the card\_id referenced on a transaction    |
| List Reimbursements | Read   | List employee reimbursements with optional filtering by user, state, or date window              |

## Example prompts

* List my recent Ramp card transactions and summarize spend by merchant and category.
* Show Ramp reimbursements that are still pending and who submitted them.
* List all active Ramp cards and their cardholders.