GetUserSubscriptions | Subscription API

Request

GetUserSubscriptionsRequest

GetUserSubscriptionsRequestapi.v1.subscription.GetUserSubscriptionsRequest2 fields

GetUserSubscriptionsRequest specifies pagination for the user's subscription list.

page

int32

The page number to retrieve (1-based).

limit

int32

The maximum number of items per page.

Request JSON

{
  "page": 1,
  "limit": 20
}

Response

GetUserSubscriptionsResponse

GetUserSubscriptionsResponseapi.v1.subscription.GetUserSubscriptionsResponse2 fields

GetUserSubscriptionsResponse contains a page of the user's active subscriptions.

dataarray

UserSubscriptionItem[]

Collection of subscription items.

max

int32

The total number of subscriptions owned by the user.

Example response

{
  "data": [
    {
      "id": 1,
      "userId": 1,
      "animeId": 1,
      "anime": {
        "id": 1,
        "slug": "frieren",
        "title": "Frieren: Beyond Journey’s End",
        "alternateTitles": "Frieren: Beyond Journey’s End",
        "generes": [
          "string value"
        ],
        "imdb": "string value",
        "tmdb": 1,
        "desc": "Example content"
      },
      "language": "de",
      "createdAt": "2026-08-19T20:15:00Z",
      "languages": [
        "de"
      ],
      "unreadReleaseCount": 1
    }
  ],
  "max": 1
}

Referenced models

8 nested message types

UserSubscriptionItemapi.v1.subscription.UserSubscriptionItem12 fields

UserSubscriptionItem represents a single active subscription entry.

id

uint32

Unique database identifier for the subscription entry.

userId

uint32

The ID of the user who owns the subscription.

animeId

uint32

The ID of the anime being followed.

anime

Anime

Full metadata for the subscribed anime.

language

string

The language identifier for this subscription.

createdAt

string

Timestamp when the subscription was created (RFC3339 format).

languagesarray

string[]

All active language identifiers for this anime.

unreadReleaseCount

int32

Number of unread release events for this anime.

latestRelease

SubscriptionRelease

Most recent release event matching this subscription.

inAppNotificationsEnabled

bool

Whether this subscription creates in-app notification rows for releases.

lastReadAt

int64

Unix timestamp for the read cursor of this anime subscription.

lastVisitedAt

int64

Unix timestamp for the last subscription inbox visit.

Animeapi.v1.models.Anime21 fields

Anime represents the high-level metadata for an anime series or movie.

id

uint32

Unique database identifier for the anime.

slug

string

URL-friendly identifier for the anime (e.g., "cowboy-bebop").

title

string

The primary title of the anime.

alternateTitles

string

A string containing alternative titles (comma-separated or JSON).

generesarray

string[]

A list of genre names associated with the anime.

imdboptional

string

Optional IMDb identifier.

tmdboptional

int32

Optional TMDB identifier.

descoptional

string

A long-form description or synopsis of the anime.

startoptional

int32

The year the anime started airing.

endoptional

int32

The year the anime finished airing.

poster

string

URL to the anime's primary poster image.

voteAvgoptional

float

Average user rating (e.g., 0.0 to 10.0).

voteCountoptional

int32

Total number of user ratings received.

tmdbType

string

TMDB content type (e.g., "tv", "movie").

anilistoptional

int32

Optional Anilist identifier.

backdrop

string

URL to the anime's horizontal backdrop image.

itemType

string

High-level item type (e.g., "anime", "hentai").

animeSeasonsarray

AnimeSeason[]

Relations: Collection of seasons associated with this anime.

animeGroupsarray

AnimeGroup[]

Relations: Collection of grouping metadata (e.g., for Anilist mapping).

trailerSite

string

Trailer provider. Currently "youtube" when a preview is available.

trailerId

string

Provider-specific trailer identifier. This is not an arbitrary URL.

AnimeSeasonapi.v1.models.AnimeSeason3 fields

AnimeSeason represents a specific season or category of episodes for an anime.

id

uint32

Unique database identifier for the season.

season

string

The season identifier (e.g., "1", "2", "OVA").

animeEpisodesarray

AnimeEpisode[]

Collection of episodes belonging to this season.

AnimeEpisodeapi.v1.models.AnimeEpisode6 fields

AnimeEpisode represents a single episode within an anime season.

id

uint32

Unique database identifier for the episode.

episode

string

The episode identifier (e.g., "1", "12").

imageoptional

string

URL to an episode-specific thumbnail or image.

animeSeasonId

uint32

The ID of the parent season.

animeEpisodeLinksarray

AnimeEpisodeLink[]

Collection of streaming hoster links for this episode.

episodeNoticeoptional

string

Optional notice message to display instead of the player (e.g., during takedowns).

AnimeEpisodeLinkapi.v1.models.AnimeEpisodeLink4 fields

AnimeEpisodeLink represents a specific streaming hoster URL for an episode.

id

uint32

Unique database identifier for the link.

link

string

The raw URL to the streaming hoster or file.

lang

string

The language identifier for the link (e.g., "ger-dub", "eng-sub").

name

string

Human-readable name of the hoster (e.g., "Voe", "DoodStream").

AnimeGroupapi.v1.models.AnimeGroup21 fields

AnimeGroup represents a mapping layer between the local database and Anilist.

id

uint32

Unique database identifier for the group record.

animeId

uint32

The ID of the local anime being grouped.

anilistId

int32

The associated Anilist media identifier.

slug

string

URL-friendly identifier for the group (usually matches the anime slug).

title

string

Primary title.

romajiTitle

string

Title in Romaji script.

nativeTitle

string

Title in native script (Japanese).

desc

string

Description or synopsis from Anilist.

cover

string

URL to the cover image from Anilist.

startDate

string

Start date of the group content (YYYY-MM-DD).

endDate

string

End date of the group content (YYYY-MM-DD).

status

string

Airing status from Anilist (e.g., "FINISHED", "RELEASING").

episodes

int32

Total number of episodes in this group.

format

string

Release format (e.g., "TV", "MOVIE", "OVA").

season

string

Season name (e.g., "SPRING", "SUMMER").

year

int32

Release year.

generesarray

string[]

List of genres from Anilist.

tagsarray

string[]

List of descriptive tags from Anilist.

prequelIdoptional

uint32

Optional ID of the preceding anime group.

sequelIdoptional

uint32

Optional ID of the succeeding anime group.

animeGroupEpisodesarray

AnimeGroupEpisode[]

Relations: Collection of local episodes mapped to this Anilist group.

AnimeGroupEpisodeapi.v1.models.AnimeGroupEpisode5 fields

AnimeGroupEpisode maps a specific local episode to an Anilist group with ordering.

id

uint32

Unique database identifier for the mapping.

animeGroupId

uint32

ID of the parent anime group.

animeEpisodeId

uint32

ID of the local anime episode.

order

int32

The display order or absolute episode number within the group.

animeEpisodeoptional

AnimeEpisode

Enriched field: The full local episode metadata.

SubscriptionReleaseapi.v1.subscription.SubscriptionRelease13 fields

SubscriptionRelease represents a release event for a subscribed anime.

id

uint32

Unique database identifier for the release event.

animeId

uint32

Anime database identifier.

anime

Anime

Full metadata for the released anime.

slug

string

Anime slug.

season

string

Released season.

episode

string

Released episode.

language

string

Release language.

title

string

Display title for the release event.

link

string

App path for opening the released episode.

image

string

Optional image URL or path for the release.

createdAt

int64

Unix timestamp when this release event was created.

isRead

bool

Whether the release has been read by the current user.

isNewSinceLastVisit

bool

Whether the release was created after the user's previous subscription inbox visit.

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.

Request example

curl 'https://fireani.me/api.v1.subscription.SubscriptionService/GetUserSubscriptions' \
  -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --data-raw '{
  "page": 1,
  "limit": 20
}'