Postman is a popular application for API development and testing. To help you get started with our API, we provide a Postman collection that you can use to make requests to our API.

This guide will walk you through how to install Postman, load the custom collection and environment, and start making API calls.

​
Prerequisites

Before you can use the Postman collection, you’ll need to download and install Postman. You can download the latest version of Postman from the Postman website.

​
Installation

Once you have installed Postman, you can load the collection and environment with one click using the below button.

​
Manual installation

Although the most convenient way, this collection is only updated occasionally. An auto-updated collection can be manually installed but will require manually updating to the latest version.

​
Environment setup

Before you can start making API calls, you need to configure the Postman environment with your API key and some other information.

  1. In the top right corner of the Postman window, select the Gr4vy environment from the dropdown menu.
  2. Click on the Environment quick look icon (the eye icon) to the right of the environment dropdown.
  3. In the Environment tab, you will see a list of variables. You need to set the following variables:
    • baseUrl - Please set this to your own production or sandbox URL.
    • privateKey - Set this to the RSA private key you prefer to use
    • thumbprint - The thumbprint, or key ID, for the private key. This is visible in our dashboard.
    • scopes - A list of API scopes to use for each request.
    • embed - Any additional embed parameters you want to add.
    • merchantAccountId - The merchant account ID on your instance.

​
Using the Collection

Once you have configured the environment, you can start making API calls.

  1. In the top right corner of the Postman window, select the Gr4vy environment from the dropdown menu.
  2. In the Collections tab on the left side of the Postman window, expand the Gr4vy API collection.
  3. You will see a list of API endpoints, organized into folders.
  4. Select an API endpoint that you want to call.
  5. The request details will be displayed in the main Postman window.
  6. Click the Send button to make the API call.

The API response will be displayed in the Response section at the bottom of the Postman window.

​
Further Information

For more information on the Gr4vy API, please refer to our API Reference.

If you have any questions or need help with the Postman collection, please contact our support team.