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.

Skip to content
Paddle Docs home

Unknown entity

The entity you're querying isn't a recognized queryable metric.

Example response
{
"error": {
"type": "request_error",
"code": "unknown_entity",
"detail": "The entity 'transactions.completed' is not recognized.",
"documentation_url": "https://developer.paddle.com/errors/metrics/unknown_entity"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
unknown_entity
Error message
The entity '%s' is not recognized.

Common causes

  • The entity in your request doesn't match a queryable metric.
  • There's a typo in the entity name.

Troubleshooting

  • Call list Explore metric entities without the entity query parameter and use one of the entity names it returns.
  • Confirm the spelling of the entity query parameter.

Was this page helpful?