Postman Guide

# Prerequisites

* [Introduction](doc:introduction)
* [Quickstart Guide](doc:quickstart) or [Developer Sandbox Quickstart](doc:sandbox-quickstart)

# Overview

Postman is an application designed to help with API integration and exploration. Intuitive for different tech skill levels, this is the tool of choice both for experienced developers and no-code enthusiasts to get familiar with our available endpoints, requests, and responses.

Using our Postman Collection, you can start testing our API before you write a single line of code.

# Install Postman and Fireblocks Collection

1. Download and install the [Postman app](https://www.postman.com/downloads/) or [use Postman online.](https://identity.getpostman.com/login?continue=https%3A%2F%2Fweb.postman.co%2Fhome)
2. <a href="https://www.postman.com/fireblockshq/fireblocks/collection/" target="_blank">
     <button type="button">
       <img src="https://run.pstmn.io/button.svg" alt="Run In Postman" style={{ width: "128px", height: "32px" }}>
     </button>
   </a>

After following the steps above and opening Postman, you'll see the Fireblocks API collection.

> 🚧 Important
>
> Running calls in Postman for the Fireblocks API will not work unless you've properly configured your authentication settings for your environment.
>
> [Learn more about properly configuring your workspace.](doc:quickstart#workspace-preparation)

# Update environment variables

The Fireblocks Postman Collection comes with a built-in Fireblocks boilerplate environment (template).

Step 1: On the top right corner, select **No Environment** and then choose **Boilerplate Fireblocks Environment**.

<Image align="center" width="200px" src="https://files.readme.io/a6d5d49-image.png" />

Step 2: Select the eye icon next to it:

<Image align="center" width="200px" src="https://files.readme.io/88447a4-image.png" />

On the next screen, add three variables:

1. `fireblocksApiKey`: This is the API key you downloaded from the **Users** tab in Fireblocks Console.
2. `fireblocksSecretKey`: This is the `fireblocks_secret.key` file you created in the [Quickstart Guide](doc:quickstart).  
   You can set the `type` to be "secret" in order to hide the secret key content.
3. `baseUrl`: This should be set to either of the following, depending on the environment you are using:  
   Mainnet/Testnet:  `https://api.fireblocks.io/v1`  
   Developer Sandbox: `https://sandbox-api.fireblocks.io`

The result will look something like this:

![](https://files.readme.io/fc8a683-image.png)

# Making your first request

> 🚧 Important
>
> This Postman Collection makes use of a [pre-request script](https://learning.postman.com/docs/writing-scripts/pre-request-scripts/) to automatically generate the `Authorization` header for every request, which allows you to skip coding the signature process.  
> You can view this script by clicking on the "Pre-request Script" tab within the Collection.

1. The first API you will call is [List vault accounts (Paginated)](ref:get_vault-accounts-paged) in your workspace.
2. **Fireblocks API > vault > List vault accounts (Paginated)**

<Image align="center" width="300px" src="https://files.readme.io/8fd9c0f-image.png" />

3. An HTTP-200 "OK" response will be shown upon a successful API call.

# What's next?

* [API Reference](https://developers.fireblocks.com/reference/api-overview)