Errors

Every error code the PkmnPrices API returns, what causes it, and the JSON shape of an error response.

The API uses standard HTTP status codes. Every error response carries a JSON body with error.code, error.message and error.docs_url — the last pointing at the page that answers what to do about it, so a caller can surface a useful link without hard-coding one.

Status	Code	Description
`400`	`bad_request`	Invalid request parameters
`401`	`unauthorized`	Missing or invalid API key
`403`	`forbidden`	API key lacks permission for this resource
`404`	`not_found`	Resource not found
`429`	`rate_limited`	Too many requests — slow down
`500`	`internal_error`	Something went wrong on our end

json

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Pass a valid key in the X-API-Key header.",
    "docs_url": "https://www.pkmnprices.com/docs#authentication"
  }
}

A 429 means the day’s credits are spent or the per-minute limit was exceeded — rate limits and credits covers both. A 403 is usually plan-gated data rather than a bad key, which the plan comparison settles.