Learn how to configure Postman to start testing Belvo' products in sandbox or production environment.

You can use Postman to test the entire functionality of Belvo without coding a single line.

Install the Collection

To install the Postman Collection, you must install the Postman App for Windows, Mac or Chrome.

Use this button to install the collection:

Postman will prompt whether you want to open the Collection in Postman for Chrome or Postman for Windows / Mac.

Select the application you installed:

Postman application will open and the collection will be imported.

Configure Postman

Belvo offers two environments:

• Sandbox, a test environment with fake data for development phases
• Production, a live environment used with real connections to institutions

Our Postman collections make use of environment variables to customize the requests that are sent. Read more about Postman environments at setting up an environment with variables.

Create an environment and configure the following variables:

• secretId: your Secret Key ID
• secretPassword: your Secret Key PASSWORD
• baseUrl: https://sandbox.belvo.co (for sandbox) or https://api.belvo.co (for production)

Check our guide on how to Get your Belvo API keys if you do not know where to find secretId and secretPassword.

👍

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

Execute a request

Once the environment is configured, you can follow these steps to execute an Belvo API method. We are reproducing the steps to make a GET call to the Institutions endpoint to retrieve the available institutions we can gather information from.

Select the environment you want to work with

Select the relevant API method in the collection folder

Click the Send button

Watch a tutorial

Follow all previous steps and see our Postman collection in action in the following video:

Keep testing

Explore the different endpoints available in our Postman collection.
Check our API reference documentation to get each endpoint specification.