TVmaze user

Check if a network is followed

Check if a person is followed

Check if a show is followed

Check if a show is voted for

Check if a webchannel is followed

Check if an episode is marked

Check if an episode is voted for

Create a new tag

Delete a specific tag

Follow a network

Follow a person

Follow a show

Follow a webchannel

List all shows under this tag

List all tags

List the episodes voted for

List the followed networks

List the followed people

List the followed shows

List the followed webchannels

List the marked episodes

List the shows voted for

List watched and acquired episodes for a show

This endpoint can be used by all users, even without premium

Mark an episode

Set `marked_at` to `NULL` or leave it out to use the current time.

Mark an episode as acquired or watched based on its ID

This endpoint can be used by all users, even without premium

Mark episodes as acquired or watched based on their IDs

This endpoint can be used by all users, even without premium

Mark episodes within a show as acquired or watched based on their attributes

To specify a show, supply either `tvmaze_id`, `thetvdb_id` or `imdb_id`. To specify an episode, supply either both `season` and `episode`, or `airdate`. This endpoint can be used by all users, even without premium.

Poll whether an authentication request was confirmed

Using the token acquired in the `start` endpoint, you can start polling this endpoint once every 10 seconds. When the user has confirmed the authentication request on their end, this endpoint will return the user's API key that you can use in subsequent authenticated endpoints. Note that it'll do so only once, subsequent requests after the initial 200 response will return a 404. For as long as the user did not yet confirm their authentication request, this endpoint will return a 403.

Remove a show vote

Remove an episode vote

Start an authentication request

If you want to access the TVmaze API on behalf of a user without querying them for their password, use this endpoint. To get started, send a POST request containing the user's email address. The response will contain a `token`, which you can use as input to the `poll` endpoint. The user will receive an email prompting them to confirm the authentication request. Alternatively, if you expect the user to be logged in to TVmaze on the device they are currently interacting with, you can set `email_confirmation` to false and redirect them to the `confirm_url` URL. If they are logged in to TVmaze, they will be able to confirm the authentication request instantly.

Tag a show

Unfollow a network

Unfollow a person

Unfollow a show

Unfollow a webchannel

Unmark an episode

Untag a show

Update a specific tag

Validate your authentication credentials

If the credentials supplied as HTTP basic are valid, the user's level of premium - if any - is returned.

Vote for a show

Set `voted_at` to `NULL` or leave it out to use the current time.

Vote for an episode