> ## 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 PRP API

> Download the PRP Postman collection and environment directly from the API, set your credentials, and send sample requests to every Payroll Point endpoint.

A Postman collection has been established to make testing the Payroll Point 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 Payroll Point API endpoints.  |
| `GET /postman/environment` | The environment variables used across those requests. |

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

<Info>
  **Both endpoints require a JWT**

  Authorize with a JWT returned from the `/authentication/login` endpoint, not your API key or authorization hash. See [Payroll Point API overview](/prp/api-reference/overview) for how to request one.
</Info>

## Import into Postman

<Steps>
  <Step title="Authorize in Swagger and download both files">
    Authorize in the Swagger UI, 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` and point `apiDomain` at the environment you're testing against.
  </Step>
</Steps>

## Environment variables

| Variable         | Value                                                                                                                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `apiDomain`      | The base domain for your target environment: `https://api.symmetry.com` for production, `https://api-staging.symmetry.com` for staging.                                                        |
| `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). |
| `accessToken` \* | Provided in the response from the `/authentication/login` (GET) endpoint. Valid for 24 hours after response.                                                                                   |
| `ver`            | API version. Payroll Point is currently on `v1`.                                                                                                                                               |

\* Set automatically in Postman after an authentication call. You do not need to enter a value when you set up your environment file.

## PRP API Postman demo

<iframe src="https://player.vimeo.com/video/780880800?h=8ca61ab2d9&badge=0&autopause=0&player_id=0&app_id=58479" title="PRP API Postman Collection" width="100%" height="400" style={{ border: 0, width: "100%", aspectRatio: "16 / 9" }} allowFullScreen />