FIREANIME API
Browse API97 operations
POST

ListAnimesWatchStatus

ListAnimesWatchStatus retrieves a paginated list of animes filtered by their watch status.

/api.v1.watch.WatchService/ListAnimesWatchStatus Bearer required
01

Request

ListAnimesWatchStatusRequest

ListAnimesWatchStatusRequestapi.v1.watch.ListAnimesWatchStatusRequest3 fields

ListAnimesWatchStatusRequest contains filters and pagination for the user's list.

page
int32

The page number to retrieve (1-based).

status
string

Filter by a specific status (e.g., "watching").

userIdoptional
string

Optional user ID to view another user's public list.

Request JSON
{
  "page": 1,
  "status": "active",
  "userId": "string"
}
02

Response

ListAnimesWatchStatusResponse

ListAnimesWatchStatusResponseapi.v1.watch.ListAnimesWatchStatusResponse2 fields

ListAnimesWatchStatusResponse contains a page of animes with the specified status.

dataarray
ListAnimeWatchStatusItem[]

Collection of anime summaries.

max
int32

The total number of animes with this status.

Example response
{
  "data": [
    {
      "updatedAt": "1",
      "animeId": 1,
      "slug": "frieren",
      "title": "Frieren: Beyond Journey’s End",
      "start": 1,
      "end": 1,
      "poster": "https://example.com/image.webp",
      "backdrop": "https://example.com/image.webp"
    }
  ],
  "max": 1
}
03

Referenced models

1 nested message types

ListAnimeWatchStatusItemapi.v1.watch.ListAnimeWatchStatusItem8 fields

ListAnimeWatchStatusItem represents a summary of an anime in a user's list.

updatedAt
int64

Unix timestamp (milliseconds) of the last status update.

animeId
uint32

ID of the anime.

slug
string

URL-friendly identifier for the anime.

title
string

Public title of the anime.

startoptional
int32

Optional start year/date.

endoptional
int32

Optional end year/date.

poster
string

URL to the anime's poster.

backdrop
string

URL to the anime's backdrop.

04

Error handling

Common failure codes

unauthenticatedThe Bearer token is missing or invalid.

invalid_argumentThe request payload failed validation.

internalThe service could not complete the operation.