---
title: "Mark episodes as acquired or watched based on their IDs"
method: POST
path: "/scrobble/episodes"
tags: ["scrobbling"]
---

# Mark episodes as acquired or watched based on their IDs

`POST /scrobble/episodes`

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

## Request body

- object[]
  - `episode_id` integer — The TVmaze episode ID
  - `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)
