---
title: "Mark episodes within a show as acquired or watched based on their attributes"
method: POST
path: "/scrobble/shows"
tags: ["scrobbling"]
---

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

`POST /scrobble/shows`

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.

## Query parameters

- `tvmaze_id` integer
- `thetvdb_id` integer
- `imdb_id` integer

## Request body

- object[]
  - `season` integer — The season number
  - `episode` integer — The episode number
  - `airdate` string, date — The episode airdate
  - `marked_at` integer — Epoch timestamp for when the user watched the episode, or 0 for unknown.
  - `type` unknown

## Response `200`

All episodes were succesfully marked

- object[] — A list of responses to your bulk input, ordered the same as your input
  - `code` integer — The HTTP code that corresponds to this item
  - `message` string — A human-readable error message (in case of error)
  - `errors` object — A list of validation errors for this item (in case of error)
  - `input` object — The request data that belonged to this response (in case of error)
  - `result` object — The resulting created/updated object (in case of success)

## Other responses

- `207` — Some episodes were succesfully marked, but there are errors
- `422` — None of the episodes were succesfully marked

---

[API](https://skmtc.net/tvmaze/apis/tvmaze-user-api.md) · [All operations](https://skmtc.net/tvmaze/apis/tvmaze-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tvmaze/tvmaze-user-api/versions/4a251a7b3226/schema)