Skip to main content

Base URL

https://api.platendoc.com/v1

Authentication

All endpoints require an API key passed as a Bearer token:
Authorization: Bearer pdc_live_xxxxxxxxxxxxxxxx
See Authentication for details on creating and scoping API keys.

Error envelope

All errors return a consistent JSON body:
{
  "error": {
    "code": "TEMPLATE_NOT_FOUND",
    "message": "Template not found.",
    "details": {}
  }
}

Error codes

CodeHTTPDescription
UNAUTHORIZED401Missing or invalid API key
API_KEY_INVALID401Key does not exist
API_KEY_REVOKED401Key has been revoked
FORBIDDEN403Key lacks the required scope
TEMPLATE_NOT_FOUND404Template not found or archived
GENERATION_NOT_FOUND404Generation not found
INVALID_DATA422Request body failed validation
LIMIT_EXCEEDED429Plan document limit reached
RATE_LIMITED429Too many requests

Pagination

List endpoints use cursor-based pagination. The response includes:
{
  "data": [...],
  "nextCursor": "gen_01j8z...",
  "hasMore": true
}
Pass nextCursor as the cursor query parameter on the next request to fetch the next page. When hasMore is false, you’ve reached the end.