Skip to main content
Version: 1.0.0


You can manage most of Permit's functionality from the web application.

That being said, you may want to use the API from time to time.

This can be achieved with Postman or any other REST client as well as with CLI tools like curl.


You can downdload Postman and use it to test the API.

The API docs are available at

An example how to use postman to query the API:


You can use the curl command line tool to use or test the API. In order to do that, you will need to get the ACCESS_TOKEN from the web application.

Go to and click on the Login button. Then open the Developer Tools menu and click on the Network tab. There you can filter for requests and take the token from the authorization header as seen in the picture below.

Get Bearer token Screenshot The Authorization header is marked, you will see it in the requests for

Then you can replace the ACCESS_TOKEN with the one you got from the web application.

Get all users

Run it with the following command to get all the users in your organization:

curl -H "Authorization: Bearer <ACCESS_TOKEN>"

Get all tenants

Use this command to get all your tenants:

curl -H "Authorization: Bearer <ACCESS_TOKEN>"