FIREANIME API
Browse API97 operations
POST

GetAnimeWatchStatus

GetAnimeWatchStatus retrieves the current watch status for a specific anime.

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

Request

GetAnimeWatchStatusRequest

GetAnimeWatchStatusRequestapi.v1.watch.GetAnimeWatchStatusRequest1 fields

GetAnimeWatchStatusRequest identifies the anime to check.

animeId
uint32

ID of the anime.

Request JSON
{
  "animeId": 1
}
02

Response

GetAnimeWatchStatusResponse

GetAnimeWatchStatusResponseapi.v1.watch.GetAnimeWatchStatusResponse1 fields

GetAnimeWatchStatusResponse contains the user's current status for the anime.

data
AnimeWatchStatus

The watch status record.

Example response
{
  "data": {
    "id": 1,
    "createdAt": "2026-08-19T20:15:00Z",
    "updatedAt": "1",
    "animeId": 1,
    "status": "active",
    "userId": 1
  }
}
03

Referenced models

1 nested message types

AnimeWatchStatusapi.v1.watch.AnimeWatchStatus6 fields

AnimeWatchStatus represents the user's current progress/intent for an anime.

id
uint32

Unique database identifier for the status record.

createdAt
string

Timestamp when the status was first set (RFC3339 format).

updatedAt
int64

Unix timestamp (milliseconds) of the last update.

animeId
uint32

ID of the associated anime.

status
string

The watch status string (e.g., "watching", "completed", "on_hold", "dropped", "plan_to_watch").

userId
uint32

The ID of the user who owns this record.

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.