For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Invalid API key

The API key used for your request isn't valid.

Example response
{
"error": {
"type": "request_error",
"code": "invalid_token",
"detail": "Invalid or revoked API key.",
"documentation_url": "https://developer.paddle.com/errors/shared/invalid_token"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
403
Error code
invalid_token
Error message
Invalid or revoked API key.

Common causes

  • The API key you used isn't correct.
  • If the API key worked previously, it may have been revoked.
  • The API key you specified is for another environment. For example, you're trying to work with sandbox using a live API key.

Troubleshooting

  • Check that the API key exists in your Paddle dashboard.
  • Create a new API key in your Paddle dashboard and revoke the key you're trying to use, if necessary.
  • Check that you're using an API key, not a client-side token. Client-side tokens are for use in your frontend.
  • Check that you're using the correct API key for the environment. Sandbox API keys start with pdl_sdbx_apikey_ and live API keys start with pdl_live_apikey_.
  • Looking to get started? Fork our Postman collection.

Was this page helpful?