# Postman Collection

## Ortege API Postman Collection Documentation

The [**Ortege API Postman Collection**](https://github.com/Ortege-xyz/postman) provides developers with a convenient way to explore and interact with the Ortege API. This collection includes pre-built requests for accessing blockchain data across REST, GraphQL, and WebSocket endpoints. By using this collection, you can quickly test queries, explore data structures, and integrate Ortege’s powerful datasets into your applications.

***

### 1. Getting Started

#### Prerequisites

To get started with the Ortege API Postman Collection, you’ll need:

1. [**Postman**](https://www.postman.com/downloads/): Download and install Postman from here.
2. **JWT Token**: Obtain a JWT token from the Ortege team for secure API access.

#### Importing the Collection

1. Download the Ortege API Postman Collection JSON file from the [Github Repository.](https://github.com/Ortege-xyz/postman)
2. In Postman, go to **File > Import**, choose the JSON file, and import it.

#### Setting Up the Environment

Creating an environment allows you to manage variables like your JWT token and the base API URL, making it easy to switch environments or update configurations.

1. In Postman, go to **Environments** > **+ New Environment**.
2. Name your environment (e.g., “Ortege API”).
3. Add the following variables:
   * **`jwt_token`**: Enter your JWT token value here.
   * **`base_url_rest`**: Set this to `https://api-staging.ortege.ai/cubejs-api/v1` for REST

#### Configuring Authorization

1. Open the imported collection.
2. Go to the **Authorization** tab of the collection.
3. Select **Bearer Token** as the authorization type.
4. Set the **Token** field to `{{jwt_token}}` to link to your environment variable.

***

### 2. Troubleshooting Common Issues

* **401 Unauthorized Error**: Verify your JWT token is correct and included in the `jwt_token` variable within your environment.
* **Query Syntax Errors**: Check the structure of your query against the [**Query Syntax Documentation**](https://docs.ortege.ai/en/ortege-products/api/query-syntax) to ensure it’s valid for the API endpoint.