> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up Postman

> How to set up Postman for use with the Quai Network API.

Our team has created a [Postman collection for Quai Network](https://docs.api.qu.ai/), which includes all of the publicly available API calls for go-quai bundled with documentation, examples, and environment variables. Postman provides a user-friendly interface for making API requests to a go-quai node without having to deal with long `curl` commands or JSON-RPC payloads. A JSON formatted version of the Quai Postman collection can be found in the [`quai-postman-collection` repository](https://github.com/dominant-strategies/quai-postman-collection).

## Introduction to Postman

Postman is a popular API client that makes it easy to send requests, test endpoints, and share collections of methods through a unified and scalable interface. Postman is available as both a **desktop application** and **web application** available on Linux, MacOS, and Windows. *The desktop application is the most feature-rich and is recommended for most users*.

The Quai Postman collection ships with a full library of API request templates and commonly used environment variables so you don't have to constantly re-write requests or variable definitions. Using the Quai Postman collection, you can interact with any Quai Network client *with minimal code and configuration*.

## Configuration

<Steps>
  <Step title="Install Postman">
    As mentioned above, Postman is available as both a desktop application and web application. While the web application is convenient for quick access, **we recommend using the desktop application** for access to all features and better performance.

    To download the Postman desktop application, visit the [Postman website](https://www.postman.com/downloads/) and download the version for your operating system. Once downloaded, it is recommended that you sign up with an email address to save and sync your collections across devices and platforms.

    <Frame>
      <img src="https://mintcdn.com/dominantstrategies/BvvhftC0HW11EtQX/images/Postman/PostmanDownload.jpg?fit=max&auto=format&n=BvvhftC0HW11EtQX&q=85&s=63314f043b0b4d1b2540757ba49b3283" width="474" height="579" data-path="images/Postman/PostmanDownload.jpg" />
    </Frame>
  </Step>

  <Step title="Import Quai API Collection">
    Postman supports raw collection imports from a URL or a local file. To import the Quai Postman collection, click the `Import` button in the top left corner of the Postman application:

    <Frame>
      <img src="https://mintcdn.com/dominantstrategies/X4sucm2SYhI37-ls/images/Postman/PostmanImportButton.png?fit=max&auto=format&n=X4sucm2SYhI37-ls&q=85&s=15d2eb71560d54fb66b76d742ac83080" width="513" height="84" data-path="images/Postman/PostmanImportButton.png" />
    </Frame>

    This will open the import options modal:

    <Frame>
      <img src="https://mintcdn.com/dominantstrategies/X4sucm2SYhI37-ls/images/Postman/PostmanImportModal.png?fit=max&auto=format&n=X4sucm2SYhI37-ls&q=85&s=ca17a959e3c4bcffa9f3d1e7ef9f3567" width="643" height="438" data-path="images/Postman/PostmanImportModal.png" />
    </Frame>

    To import the Quai Postman collection, paste the following URL into the `Paste cURL, Raw Text, or URL...` field:

    ```
    https://raw.githubusercontent.com/dominant-strategies/quai-postman-collection/main/go-quai.postman_collection.json
    ```

    Once the import has completed, you'll see the **Quai Postman Collection** in the left sidebar of the Postman application:

    <Frame>
      <img src="https://mintcdn.com/dominantstrategies/BvvhftC0HW11EtQX/images/Postman/PostmanCollection.png?fit=max&auto=format&n=BvvhftC0HW11EtQX&q=85&s=75733d26e3a3ee031b0d27ff045d8d58" width="515" height="187" data-path="images/Postman/PostmanCollection.png" />
    </Frame>
  </Step>

  <Step title="Import Environment Variables">
    Now that we have the Quai Postman collection imported, we need to import the environment variables. To import the Quai Postman environment variables, click the `Import` button in the top left corner of Postman like before, but this time, **paste the URL to the environment variables file**:

    ```
    https://raw.githubusercontent.com/dominant-strategies/quai-postman-collection/main/example-quai-environment.postman_environment.json
    ```

    Postman will automatically recognize the format of the environment variables file. When the import is complete, you should see this modal in the left right corner of the Postman application:

    <Frame>
      <img src="https://mintcdn.com/dominantstrategies/X4sucm2SYhI37-ls/images/Postman/PostmanImportSuccess.png?fit=max&auto=format&n=X4sucm2SYhI37-ls&q=85&s=2675844d5654871f4b77b4e9d1344cc5" width="377" height="134" data-path="images/Postman/PostmanImportSuccess.png" />
    </Frame>

    Lastly, you'll need to select the `Example Quai Postman Environment` from the dropdown in the top right corner of the Postman application:

    <Frame>
      <img src="https://mintcdn.com/dominantstrategies/BvvhftC0HW11EtQX/images/Postman/PostmanEnvironmentSelect.png?fit=max&auto=format&n=BvvhftC0HW11EtQX&q=85&s=8507ab96accc49935071525707fced6c" width="168" height="124" data-path="images/Postman/PostmanEnvironmentSelect.png" />
    </Frame>

    Your environment variables are now **set as the active environment** and ready to use. When set as the active environment, the Quai Postman collection will be correctly configured with RPC endpoints, addresses, and hashes!
  </Step>
</Steps>

## Conclusion

Now that you've installed Postman, imported the Quai API collection, and configured environment variables, **you're ready to start making requests to a go-quai node**. *Further documentation and tutorials* on how to use the Quai Postman collection can be found below:

**Quai Postman Guides**

* [Environment Variables Guide](/build/api/postman/environment)
* [Making Requests Guide](/build/api/postman/use)

**API Specification**

* Pre-packaged specs and examples inside of the Quai Postman Collection
* [Quai Postman Collection Documentation](https://docs.api.qu.ai/)
* [JSON-RPC API Documentation](/build/playground/overview)
