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. Open Developer apps in Ramp.
  2. For your first app, click Start building. If you already have an app, click Create new app.
  3. Name your app (e.g., “API Quickstart”) and accept the Terms.
  4. Under Grant types, confirm Client credentials is turned on.
  5. Under Scopes, click Configure allowed scopes and select the scopes available to your business that your use case needs, such as transactions:read. If a required scope is unavailable, submit a Developer API support ticket to ask about access.
  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 a separate API base URL and app credentials from production. It cannot process real money and includes demo-only simulation actions.

Requesting sandbox access

Request access using the sandbox access form. Your sandbox should be ready in about one minute. Check your inbox for an account access email. Ramp provisions a sandbox business pre-populated with sample data (such as transactions, cards, users, departments, 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

How to submit a developer API support ticket

  1. Open Developer apps:

    Company navigation with Developer highlighted

  2. Click Developer API Support.

  3. In Ask Ramp, describe your issue and ask to connect with the Developer Support team:

    Ask Ramp new chat with generic suggested questions

  4. Review the pre-filled Description, enter a Subject, and add any other missing details:

    Developer Support ticket form with an empty Subject and a pre-filled Description

  5. 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.