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

# Postman API setup

> Authorize your NodeMaven API key and send your first request from Postman.

This guide shows how to authorize your NodeMaven API key and send a request to the NodeMaven API from Postman. For the endpoints themselves, see the [Proxy API overview](/proxy-api/overview).

## Set up Postman with the NodeMaven API

<Steps>
  <Step title="Copy the token">
    On your dashboard, go to **profile** > **API key** > **copy token**.

    <Frame>
      <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1796959864/76d6e1dba987778be5cfd33cae23/1.png" alt="NodeMaven dashboard profile menu showing the API key and copy token control" />
    </Frame>
  </Step>

  <Step title="Authorize the token">
    Click **API documentation**. Once on that page, click **Authorize**. In the value input, insert `x-api-key YOUR_API_KEY` and click **authorize**, then close the dialog.

    <Frame>
      <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1796960080/f21f323221eebbab43b41f373a98/2.png" alt="API documentation Authorize dialog with the x-api-key value" />
    </Frame>
  </Step>

  <Step title="Test the authorization">
    Choose an API GET endpoint, click **Try it out**, then **execute**. You should get a `200 OK` code. If you get an error instead, check the token authorization.

    <Frame>
      <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1796960280/0c7976766453fcb81f4a16c32f6d/3.png" alt="API documentation showing a 200 OK response from a GET request" />
    </Frame>
  </Step>

  <Step title="Set up the request in Postman">
    In Postman, select **GET** and add the request URL, for example:

    ```text theme={null}
    https://api.nodemaven.com/api/v2/base/locations/countries/
    ```

    <Frame>
      <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1796960652/ac04363895a56f10b722180df9c7/4.png" alt="Postman with the GET method and request URL entered" />
    </Frame>
  </Step>

  <Step title="Add headers and send">
    Select the **Headers** tab and insert the following:

    | Key | Value |
    | - | - |
    | Authorization | `x-api-key YOUR_API_KEY` |
    | Content-type | `Application/json` |

    Click **Send**, and you should get a `200 OK` status.

    <Frame>
      <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1796960749/6ae14fb5d5c462573d79aed2d6b8/5.png" alt="Postman Headers tab with the authorization and content-type headers and a 200 OK response" />
    </Frame>
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.