Skip to main content
The Symmetry Payroll Point (PRP) API identifies and determines complex state and local taxes from an employee’s home and work addresses, returning results in JSON. The endpoint reference in this section is generated from the PRP OpenAPI specification.
New to the PRP API? Start with the Quickstart: Call the Payroll Point API for a complete first request, then use this reference for full endpoint and schema details.

​
Environments and base URLs

The primary endpoint that returns taxes for an employee’s home and work location is /prp/v1/taxes.
Always develop and test against the staging environment before pointing your integration at production.

​
Authentication

Every PRP endpoint other than /authentication/login requires a JWT access token. Request one by calling the authentication endpoint with your API key, then send the token as a Bearer token in the Authorization header.
Tokens are valid for 24 hours. Once expired, PRP endpoints return HTTP 401 with {"message": "Unauthorized"} until you request a new one.
Access token versus API keyYour access token is not the same as your API key. The API key is used for initial authentication to obtain an access token from the /authentication/login endpoint. The access token is then used to authorize and interact with the other PRP endpoints securely.

​
Explore in Swagger

API clients can access our Swagger documentation to test and explore each endpoint, and see a comprehensive overview of all available features. Our Swagger docs are available for both our production and staging environments.

​
Authorize access to Swagger docs

To generate a token, make a request to the /authentication/login endpoint to receive a valid access token. Then click the Authorize button on the right side of the browser, enter this access token into the dialog box for the respective environment, and click Authorize.
Once authorized successfully, you’ll see an unlocked symbol appear on each of the endpoints. This is your indication that you can send the sample requests to each endpoint.
Click into the desired endpoint, select Try it out, and then Execute.
You’ll then receive the response from the endpoint.

​
Next steps

Postman

Download the PRP Postman collection and environment directly from the API.

Endpoints

Full reference for every taxes, minimum wage, and account endpoint.