Set up our Postman collection

With your API keys in hand, let's get you up and running with Postman 📬.

We've created a public Postman workspace so that you can quickly and easily start testing what data you can get using Belvo. In this article, you'll learn how to install and configure our collection.


Make sure you've installed the Postman App for Windows, Mac, or Chrome and have logged into your Postman account.
If you encounter any SSL certificate issues, please make sure you have the latest version of Postman available (you can verify by clicking on helpcheck for updates).

Fork the Belvo API Collection

To use Belvo's API collection:

  1. Go to Belvo's Postman workspace and click Watch. This way, if we ever make a change to the collection, you'll be automatically notified and you'll be able to pull the changes into your fork.
  2. Click on Fork to fork the collection into your own private workspace.

Watch the collection in the Belvo API Workspace

✳️ Done! Let's quickly configure Postman so that you can easily use our API.

Configure Postman

Our Postman collections make use of environment variables to customize the requests that are sent. You can read more about environments in Postman's setting up an environment with variables article.

To create your environment variables:

  1. In Postman, click the eye icon.
  2. In the Environment section, click Add.

Adding an Environment

  1. Name your Environment, for example: Belvo Sandbox.
  2. Add the following environment variables:
    • secretId: your sandbox Secret Key ID.
    • secretPassword: your sandbox Secret Key PASSWORD.
    • baseUrl .

Configuring the variables


Make sure that your secretId, secretPassword, and baseUrl are properly stored as the initial value AND current value. This is important to prevent potential errors.

  1. Click Save.

✳️ Awesome! But before we go on, let's make sure that everything is working just fine with a simple call.

Test that it works!

Just to make sure you've set everything up correctly, let's see that you can list all the institutions in our Sandbox environment.

  1. Make sure that you select your Belvo Sandbox environment.
  2. In the Belvo API folder, select Institutions → GET List.
  3. Click Send.

If everything is correctly set up, you should see a whole host of institutions appear!


✳️ And you're done! Now, let's make our first calls to the Belvo API!