PDP API Reference
The policy decision point (PDP) exposes its own HTTP API, separate from the Permit.io Cloud API. The Permit SDKs call this API for permission checks such as permit.check(). This page is for developers who call the PDP API directly or build their own SDK: it lists where to find the PDP OpenAPI spec and interactive API reference.
PDP API reference URLs
Every PDP serves its OpenAPI spec and an interactive API reference at these paths:
| Resource | Path |
|---|---|
| OpenAPI spec | /openapi.json |
| Interactive API reference (Redoc) | /redoc |
| Interactive API reference (Scalar) | /scalar |
Add the path to the base URL of the PDP you use:
| PDP | Base URL | OpenAPI spec |
|---|---|---|
| PDP container running on your machine | http://localhost:7766 | http://localhost:7766/openapi.json |
| Cloud PDP | https://cloudpdp.api.permit.io | https://cloudpdp.api.permit.io/openapi.json |
The local base URL assumes you map the PDP to port 7766, as in Run the PDP. If you map a different port, use that port.
Verify the PDP API is reachable
Open http://localhost:7766/redoc in a browser while the PDP container runs. The page lists the PDP endpoints, including the authorization endpoints the SDKs call. If the page does not load, check that the container is running with docker ps and that the port mapping matches.