MediaList

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/anilist/refs/heads/main/json-schema/anilist-medialist-schema.json",
  "title": "MediaList",
  "description": "List of anime or manga",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "The id of the list entry"
    },
    "userId": {
      "type": "integer",
      "description": "The id of the user owner of the list entry"
    },
    "mediaId": {
      "type": "integer",
      "description": "The id of the media"
    },
    "status": {
      "type": "string",
      "enum": [
        "CURRENT",
        "PLANNING",
        "COMPLETED",
        "DROPPED",
        "PAUSED",
        "REPEATING"
      ],
      "description": "The watching/reading status"
    },
    "score": {
      "type": "number",
      "description": "The score of the entry"
    },
    "progress": {
      "type": "integer",
      "description": "The amount of episodes/chapters consumed by the user"
    },
    "progressVolumes": {
      "type": "integer",
      "description": "The amount of volumes read by the user"
    },
    "repeat": {
      "type": "integer",
      "description": "The amount of times the user has rewatched/read the media"
    },
    "priority": {
      "type": "integer",
      "description": "Priority of planning"
    },
    "private": {
      "type": "boolean",
      "description": "If the entry should only be visible to authenticated user"
    },
    "notes": {
      "type": "string",
      "description": "Text notes"
    },
    "hiddenFromStatusLists": {
      "type": "boolean",
      "description": "If the entry shown be hidden from non-custom lists"
    },
    "customLists": {
      "type": "object",
      "description": "Map of booleans for which custom lists the entry are in"
    },
    "advancedScores": {
      "type": "object",
      "description": "Map of advanced scores with name keys"
    },
    "startedAt": {
      "$ref": "./anilist-fuzzydate-schema.json",
      "description": "When the entry was started by the user"
    },
    "completedAt": {
      "$ref": "./anilist-fuzzydate-schema.json",
      "description": "When the entry was completed by the user"
    },
    "updatedAt": {
      "type": "integer",
      "description": "When the entry data was last updated"
    },
    "createdAt": {
      "type": "integer",
      "description": "When the entry data was created"
    },
    "media": {
      "$ref": "./anilist-media-schema.json"
    },
    "user": {
      "$ref": "./anilist-user-schema.json"
    }
  },
  "required": [
    "id",
    "userId",
    "mediaId"
  ]
}