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

# Postman collection and environment for CBS API

> Download the CBS Postman collection and environment directly from the API, set your apiKey, and send sample requests to every calculator endpoint.

A Postman collection has been established to make testing the CBS API endpoints simple and intuitive. Symmetry serves the Postman files from the API itself rather than as static downloads, so the collection always reflects the current endpoints.

## Download from Swagger

Both files come from the **Postman** endpoints, and both require authorization.

| Endpoint                   | What it returns                                       |
| -------------------------- | ----------------------------------------------------- |
| `GET /postman/collection`  | Sample requests for all CBS API endpoints.            |
| `GET /postman/environment` | The environment variables used across those requests. |

<Card title="Postman endpoints in Swagger" icon="paper-plane" href="https://calculators.symmetry.com/api/docs#/Postman">
  Jump to the Postman section of the Swagger UI to execute both endpoints and save each response.
</Card>

<Info>
  **Both endpoints require your API key**

  `/postman/collection` and `/postman/environment` are authenticated with the `pcc-api-key` header. Requests without a valid key return HTTP 401. See [Authentication model](/cbs/core-concepts/authentication-model).
</Info>

## Import into Postman

<Steps>
  <Step title="Authorize in Swagger and download both files">
    Authorize in the Swagger UI with your `pcc-api-key`, then execute `GET /postman/collection` and `GET /postman/environment` and save each response as a file.
  </Step>

  <Step title="Import both files into Postman">
    In Postman, select **Import**, then add the collection file and the environment file you downloaded.
  </Step>

  <Step title="Select the environment and set your credentials">
    Activate the environment, then supply your own `apiKey`.
  </Step>
</Steps>

## Environment variables

There are two variables in the environment.

| Variable         | Value                                                                                                                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `apiKey`         | Provided by Symmetry's Client Success team. If you are unsure of your company's `apiKey`, please reach out to Client Success within the [Client Support Center](https://support.symmetry.com). |
| `endpointURL` \* | `https://calculators.symmetry.com/api/calculators/` for production.                                                                                                                            |

\* Set automatically on download. `/postman/environment` returns `endpointURL` already set for the deployment tier you download it from, so a staging download comes preconfigured for staging. The only value you need to enter by hand is `apiKey`.