Frequently Asked Question
API — Known Issues & Bug Log
Last Updated about an hour ago
A list of known issues on TheTVDB's v4 API.
HIGH-PRIORITY ISSUES:
- RemoteIDs — key is inconsistent in some places. Ready to Deploy
- /genders — 200 status are repeated as well as 200200. QA
- /entity-types — Missing endpoint. Needed for browsing of the taxonomy. QA
- /award-categories/{id} & /award-categories/{id}/extended — Same issue as above. Gives the correct award category, but wrong award. QA
- /companies/{id} — Returns 404. QA
- /episodes/{id}/translations/{language} — Discrepancy for primary language at episode level. QA
- Season episode routes — create, with links object for pagination. QA
- /artwork/{id} — Querying vs. extended series endpoint returns different results. QA
- Updates endpoint missing IN REVIEW
- /company-types — Missing endpoint. Should return a list of company types. IN REVIEW
- /lists/{id} — 404 on individual ID; should include an array of images from the first 3 entities in the list. Should also return all translations. IN REVIEW
- /content-ratings — Needs the country included in each. IN REVIEW
- /episodes/{id} — Needs episode number within each season. IN REVIEW
- /characters/{id} — Should nest the person’s base record (since it might contain a headshot image that can be used if the role image isn’t set). IN REVIEW
- /movies/{id}/extended — Trailers is empty even when not; franchises is empty even when not; issues w/ remote ids; character should include the person base record for each. IN REVIEW
- /movies/{id} — Status field isn’t complete - 0 and empty string. IN REVIEW
- /movies/{id}/translations/{language} — isPrimary isn’t properly set. IN REVIEW
- SeasonExtendedRecord.artwork — Field name is inconsistent with series.artworks. IN REVIEW
- /episodes/{id}/extended — Should include person base record for characters; Network is incorrect at the episode level.
- /seasons/{id} — Name field is returning the name of the season type, instead of the name of the season itself; network isn’t be generated correctly
- /seasons/{id}/extended — Each episode within episodes should have an episodeNumber; Name field is wrong here, too; Again, network isn’t be generated correctly here.
- /seasons/{id}/translations/{language} — isPrimary is not set correctly.
OTHER ISSUES:
- /artwork/{id}/translations/{language} — Should be removed.
- /awards/{id}/extended — Within each award category is another nested “award” that is 0 and the name is an empty string. To be fixed.
- /lists — Should be sorted by number of favorites, descending.
- tagOptions — tagOptions is set for the people extended endpoint, when it should be on every extended entity endpoint.
- /source-types — Needs reworking.
- Excessive API calls required — Doctor Who, aired order, English requires 476 API calls at minimum and 636 for the optional stuff. Currently this would take around 10 API calls. Translations need reworking
- Missing revision/lastUpdated — None of the api endpoints actually have a 'revision' nor do they expose the 'lastUpdated' information previously available.
BACKLOG:
- /countries/{id}/series — Missing endpoint.
- /countries/{id}/movies — Missing endpoint.
- /countries/{id}/networks — Should be implemented as “companies,” to return a list of companies for that country.
- /companies/{id}/movies — Should return all of the movie base records plus the company type that this company is used for
- /companies/{id}/episodes — Same as the movies one above, but for episodes.
- /companies/{id}/series — Companies aren’t really associated with series, they’re associated with episodes. But should implement in case we ever do want to associate a company at the series level.
- /companies/{id}/seriesRollup — Same as above. Would give any series that the episode is related to.
- /countries — To be removed.
- /genres/{id} — /genres/{id}/series should return a paginated list of series with this genre. Same for /genres/{id}/movies.
- /languages — To be removed.
- /movies — Returns 404.
- /people/{id}/extended — Within characters there’s a url field that’s empty for all.
- Response code for deleted series — Should exist for all records. If a record doesn’t exist, should maybe return a 410 instead of a 404.