Ramp Developer API overview

Overview

Ramp’s Developer API allows teams to programmatically access Ramp data and build automations or integrations tailored to their workflows. It provides secure, scoped access to objects like transactions, cards, users, and more. This help article explains what the API is, how to get started within the Ramp app, and where to find full technical documentation and real-time assistance. Complete reference guides, endpoint schemas, and end-to-end examples live in the Ramp Developer API documentation.

Setup guide and feature support

To begin using the Ramp Developer API, you must first create a developer app to obtain your API credentials. Admin access is required.

  1. Go to Settings > Developer in your Ramp dashboard.
  2. Click "Create New App."
  3. Name your app (e.g., “API Quickstart”) and accept the Terms.
  4. Under Grant types, click “Add new grant type” and select “Client Credentials.”
  5. Under Scopes, click “Configure allowed scopes” and select transactions:read (or additional scopes as needed for your use case).
  6. Copy your Client ID and Client Secret. Store these securely—you’ll need them to generate your access token.

Video walkthrough: Generate Ramp Developer API credentials from the Ramp dashboard. Best when you're creating your first app and need client credentials and scopes. Watch the video.

Once credentials are created, follow the this guide on how to generate an access token.

Sandbox environment

Ramp provides a sandbox environment where you can build and test your API integration before connecting to production. The sandbox is a separate environment with its own base URL and credentials — it is not a mode within the production API.

The sandbox uses the same API endpoints and scopes as production. The only difference is the base URL and the environment your credentials are associated with.

Requesting sandbox access

Sandbox access is not self-serve. To get a sandbox environment, contact your account manager. Once approved, Ramp provisions a sandbox business pre-populated with sample data (such as transactions, cards, users, departments, bills, and reimbursements) so you can test against realistic data without affecting your production account.

You will need to create a separate developer app in the sandbox environment to obtain sandbox-specific OAuth2 credentials (Client ID and Client Secret). Follow the same setup steps described in Setup Guide and Feature Support above, but within your sandbox account.

Sandbox vs. production

Third-party developer accounts cannot connect to apps in production. To test your integration, use your sandbox account and interact with the sandbox API at https://demo-api.ramp.com. Once you have built and tested in the sandbox, you can apply for production access through the Ramp Developer API documentation.

How to submit a developer API support ticket

  1. Navigate to Company > Developer In the left-hand navigation, click Company to expand the menu, then select Developer:

    Ramp left sidebar with Developer option highlighted under Company

  2. Open Developer API Support On the Developer page, click the Developer API Support card:

    Developer page showing the Developer API Support card

  3. Select "Connect to Developer Support team" In the chat window, select Connect to Developer Support team:

    Chat window with Connect to Developer Support team option highlighted

  4. Answer the agent's questions The AI assistant will ask you a few questions about your issue. Answer as completely as you can, then review the pre-filled support ticket form to confirm the details look accurate:

    AI assistant chat with pre-filled support ticket form

  5. Click "Submit Ticket" Click Submit Ticket to send your request to the team:

    Submit Ticket button at the bottom of the support ticket form

Developer assist

Developer Assist is an AI-powered helper built directly into the Ramp API documentation. It can answer questions about endpoints, parameters, errors, and implementation steps in real time.

To use it:

  1. Navigate to the Ramp Developer API docs.
  2. Click the chat icon in the bottom-right corner of the page.
  3. Type your question into the chat window to get instant guidance.

Video walkthrough: Test Ramp Developer API calls and manage scopes for your integration. Best when validating your setup or refining permissions for an existing integration. Watch the video.

For bug investigations or issues with API performance or unexpected behavior, submit a Developer API support ticket.