API ReferenceAPI ReferenceCatalog

Unscored, age-gated catalog read

Returns the namespace-pruned, age-gated, deterministically-ordered visible catalog for the caller's airline_id — no ranking, no vectors, no persona (see POST for the scored variant). The member age tier is resolved SERVER-SIDE from the bound member profile via the optional seatId + memberSlot query params (UN-TRUSTED LOCATORS only, never a trust assertion — member identity is the combination of airline, session, seat, and slot, since memberSlot alone is per-seat, not session-globally-unique) — an unresolved/unbound member, or a request with no seatId, is served the most-restrictive (child-safe) catalog, never the full one. Response coverage reports an honest ageExcludedCount and the ageTierApplied.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

kindstringOptional

Optional content-kind filter, accepted in any casing and normalized to ‘Movie’ or ‘TV’; omitted returns both kinds.

limitintegerOptional1-500

Optional page size, 1-500 inclusive; omitted returns the full age-gated/kind-filtered page.

offsetintegerOptional>=0

Optional zero-based skip count; omitted defaults to 0.

seatIdstringOptional

Untrusted locator only (never a trust assertion) — together with memberSlot, selects the bound member profile server-side; an absent or unbound value resolves to the most-restrictive (child-safe) age tier.

memberSlotstringOptional

Untrusted locator only (never a trust assertion), paired with seatId — memberSlot alone is per-seat, not session-globally-unique.

Response

OK
correlationIdstring
itemslist of objects
totalItemsinteger or string

Total visible-catalog count before age-gate exclusion.

ageExcludedCountinteger or string

Honest count of items the age gate removed — this number is always accurate, never silently omitted.

ageTierAppliedenum

The server-resolved age tier the age gate applied (never a client-asserted value).

schemaVersionstring

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error