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

# Postman Collection

> Get started with Truv APIs using the Postman collection

The Truv Postman Collection lets you get started with your integration with little to no code. It includes pre-configured requests, environment variables, and sample workflows.

<a href="https://app.getpostman.com/run-collection/48266598-603edef0-cd1e-4f39-be6f-fbefa452a03e?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D48266598-603edef0-cd1e-4f39-be6f-fbefa452a03e%26entityType%3Dcollection%26workspaceId%3D1efab6e1-96a4-493e-ab70-52b479b680b5" target="_blank">
  <img src="https://run.pstmn.io/button.svg" alt="Run in Postman" />
</a>

***

## Set up Postman

<Steps>
  <Step title="Install Postman">
    Download and install [Postman](https://www.postman.com/downloads/).
  </Step>

  <Step title="Fork the collection">
    Click the **Run in Postman** button above to fork the Truv API collection into your workspace. This imports both the collection and the Sandbox environment.
  </Step>
</Steps>

***

## Configure Postman

The Truv Postman collection uses [Postman environment variables](https://learning.postman.com/docs/sending-requests/variables/managing-environments/) to simplify each API request.

<Steps>
  <Step title="Select the Sandbox environment">
    In the top right corner of Postman, select the **Sandbox** environment.
  </Step>

  <Step title="Open environment settings">
    Click the eye icon to open the environment settings.
  </Step>

  <Step title="Add your API keys">
    Copy your Truv API keys from the [Dashboard API Keys page](https://dashboard.truv.com/app/development/keys) into the environment variables:

    * `client_id`: your Client ID
    * `access_key`: your Access Secret
  </Step>

  <Step title="Save and start">
    Save your changes and start making API requests.
  </Step>
</Steps>

***

## Sample workflow

Requests have pre-configured pre-request and post-response scripts that pass data between steps automatically.

### VOIE verification

<Steps>
  <Step title="Create an Order">
    Run **Create an Order - VOIE (Basic)**. In the response body, click the `shareURL` to complete the order in Truv Bridge.
  </Step>

  <Step title="Get the Order">
    Run **Get an Order by ID**. The `orderId` from step 1 is stored as a variable and passed through automatically.
  </Step>

  <Step title="Get the VOIE Report">
    Run **Get a VOIE Report by ID**. The `user_id` and `voie_report_id` variables from the prior response are stored and passed through automatically.
  </Step>
</Steps>