Errors
Every error code, what it means and the fix.
Every error has the same shape:
{
"error": {
"code": "plan_required",
"message": "History needs a paid plan.",
"doc_url": "https://tvguideapi.com/documentation/errors"
}
}| HTTP | Code | When | The fix |
|---|---|---|---|
| 400 | bad_parameter | A parameter is missing or not in the form the endpoint page shows | The message names the parameter; check its row in the parameter table |
| 401 | key_missing | No key, or not sent as a bearer token | Send Authorization: Bearer tvg_live_... |
| 403 | plan_required | The endpoint or the date range needs a paid plan | The message names what opens it |
| 404 | not_found | No channel, show, episode or event with that id | Find it first with a search endpoint |
| 410 | id_merged | The id was merged into another | Use meta.moved_to; the old id keeps answering 410 for a year |
| 429 | limit_reached | Today's calls are used up | Wait for Retry-After, or move to a paid plan |
| 503 | busy | Try again shortly; nothing was counted | Retry with backoff |