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

# Postman Collections

Postman is an API platform to help developers design and test APIs. Postman is an alternative to run Yuno API requests using Readme.io. You can download Postman [here](https://www.postman.com/downloads/) for Linux, Windows, or Mac or use it through your web browser.

Here, you find how to import the Yuno Collection and Environment. All endpoints on the [API Reference](/reference/getting-started/api-reference-overview)  are available on the Postman collection provided so that you can test Yuno services on your machine.

<Note>
  **Postman Collection**

  Access the Yuno APIs Postman collection [here](https://documenter.getpostman.com/view/25083296/2sBXikpXDZ?utm_source=slack\&utm_medium=link_preview\&utm_campaign=other\&utm_content=link\&utm_term=other#173ba2dd-1dbb-466c-934c-19a4308d9d80).
</Note>

## Step 1: Fork the Yuno Postman collection

Before testing the endpoints, you need to fork the Yuno collection to your Postman account.

1. Access the [Yuno Postman collection](https://documenter.getpostman.com/view/25083296/2sBXikpXDZ?utm_source=slack\&utm_medium=link_preview\&utm_campaign=other\&utm_content=link\&utm_term=other#173ba2dd-1dbb-466c-934c-19a4308d9d80).
2. Select the following **Run in Postman** button.
3. Select if you want to run Postman on your Browser or using the Postman app.
4. Sign up or log in to a Postman account.
5. Select a workspace to import the collection and environment into.

<Note>
  **Collections and Environment**

  The collections provided configured endpoint requests. The environments provide a list of variables used by the endpoints. Instead of defining values for each parameter each time you perform a request, you can use the environment variables.
</Note>

## Step 2: Configure the environment variables

Before start testing the endpoint, you need to configure the environment variables. Otherwise, the requests will fail.

1. Access **Environments** on the left panel.

<Frame>
  <img src="https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/postman-collections/image1.png?fit=max&auto=format&n=MTlogjS0_SlxtlJG&q=85&s=78407c02c969be791731752f6dd17cca" width="860" height="481" data-path="images/reference/postman-collections/image1.png" />
</Frame>

2. Select the **Yuno Sbx - Postman** environment provided by yuno.

<Frame>
  <img src="https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/postman-collections/image2.png?fit=max&auto=format&n=MTlogjS0_SlxtlJG&q=85&s=12a3170f360879483dba2e4de127c575" width="860" height="481" data-path="images/reference/postman-collections/image2.png" />
</Frame>

3. Update the variable's values. To start testing, you need to update at least the `api-key`, `secret-key`, and `account-code`.

4. Define **Yuno Sbx - Postman** as the environment using the **No Environment** selector at the top right corner.

<Frame>
  <img src="https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/postman-collections/image3.png?fit=max&auto=format&n=MTlogjS0_SlxtlJG&q=85&s=60d2ac30aaa647cd0d3e188d500acf4f" width="860" height="480" data-path="images/reference/postman-collections/image3.png" />
</Frame>

The **Yuno Sbx - Postman** environment has an extensive list of variables used on all requests inside the collection. You can define their values as you try new endpoints.

## Step 3: Run in Postman

After selecting the environment and defining the variable values, you can start testing the endpoint.

1. Select the **Yuno - Collection** on the Collections tab.
2. Choose an endpoint.

<Frame>
  <img src="https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/postman-collections/image4.png?fit=max&auto=format&n=MTlogjS0_SlxtlJG&q=85&s=3375bd68aa6156e809cfef5b9a7e1ecf" width="860" height="481" data-path="images/reference/postman-collections/image4.png" />
</Frame>

3. Provide the necessary values to the parameters available on the **Headers** and **Body** tabs.

<Frame>
  <img src="https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/postman-collections/image5.png?fit=max&auto=format&n=MTlogjS0_SlxtlJG&q=85&s=e00f3f2e21a001464cdc8689d3bb9f98" width="860" height="480" data-path="images/reference/postman-collections/image5.png" />
</Frame>

4. Use the **Send** button to perform the request to Yuno's server.

<Frame>
  <img src="https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/postman-collections/image6.png?fit=max&auto=format&n=MTlogjS0_SlxtlJG&q=85&s=94dd57cb7cfe0449c6368229c26c076a" width="860" height="480" data-path="images/reference/postman-collections/image6.png" />
</Frame>

<Note>
  **Postman Variables**

  In the Yuno Collection, various parameters are considered as variables. These values can be defined in the environment or upon receiving a response from the server. Postman variables aid in testing different endpoints in a sequence as the values received fill in the body parameters for the subsequent request.
</Note>
