FIREANIME API
Browse API97 operations
POST

ListExternalTrackingConnections

ListExternalTrackingConnections returns provider availability and the authenticated user's current linked accounts.

/api.v1.tracking.ExternalTrackingService/ListExternalTrackingConnections Bearer required
01

Request

ListExternalTrackingConnectionsRequest

ListExternalTrackingConnectionsRequestapi.v1.tracking.ListExternalTrackingConnectionsRequest0 fields

List External Tracking Connections Request message.

No fields — send an empty JSON object.
Request JSON
{}
02

Response

ListExternalTrackingConnectionsResponse

ListExternalTrackingConnectionsResponseapi.v1.tracking.ListExternalTrackingConnectionsResponse5 fields

List External Tracking Connections Response message.

syncEnabled
bool

Whether outbound delivery is currently active for this user. Local watch progress continues to be saved while false.

providersarray
ExternalTrackingProviderAvailability[]

Providers value.

connectionsarray
ExternalTrackingConnection[]

Connections value.

accessGranted
bool

Whether this authenticated user is included by the administrator's disabled/selected/public rollout policy.

accessMessage
string

Safe explanation shown when access_granted is false.

Example response
{
  "syncEnabled": false,
  "providers": [
    {
      "provider": "string value",
      "available": false,
      "unavailableReason": "string value"
    }
  ],
  "connections": [
    {
      "provider": "string value",
      "connected": false,
      "remoteUserId": "string value",
      "remoteUsername": "fireanime_user",
      "status": "active",
      "connectedAt": "string value",
      "tokenExpiresAt": "string value",
      "lastSyncAt": "string value"
    }
  ],
  "accessGranted": false,
  "accessMessage": "success"
}
03

Referenced models

2 nested message types

ExternalTrackingProviderAvailabilityapi.v1.tracking.ExternalTrackingProviderAvailability3 fields

ExternalTrackingProviderAvailability describes whether a provider can be linked. An unavailable provider has no usable admin configuration.

provider
string

Stable provider key: "anilist" or "mal".

available
bool

Whether new OAuth connections can be started for this provider.

unavailableReason
string

Safe, user-facing explanation when the provider is unavailable.

ExternalTrackingConnectionapi.v1.tracking.ExternalTrackingConnection12 fields

ExternalTrackingConnection is the safe public representation of one linked account. Access tokens, refresh tokens, and OAuth client credentials are intentionally absent.

provider
string

Stable provider key: "anilist" or "mal".

connected
bool

Whether an authenticated provider account is linked.

remoteUserId
string

Provider-owned account identifier.

remoteUsername
string

Provider-owned username or display name.

status
string

Connection state such as "connected", "reauthorization_required", or "disabled_by_admin".

connectedAtoptional
string

RFC3339 timestamp when this account was linked.

tokenExpiresAtoptional
string

RFC3339 token expiry timestamp when the provider supplied one.

lastSyncAtoptional
string

RFC3339 timestamp of the most recent successful progress write.

lastSyncError
string

Safe summary of the most recent synchronization problem.

pendingTargetCount
int64

Number of coalesced progress targets waiting or retrying for this account.

failedTargetCount
int64

Number of progress targets currently failed for this account.

profileVisible
bool

Whether this verified provider identity is visible on the user's public FireAnime profile. New connections are private by default.

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.