Returns a Public List: its header and, for a Media or Game List, every title with its top-level poster; an Asset List returns its images.
kind is assetList, mediaList or gameList. A Media or Game List holds up to 500 titles, with or without artwork (titles[]: entity, position, poster, choiceCount, updatedAt); a title's Season, Episode and other choices are on /lists/{id}/titles/{family}/{entity}. An Asset List returns its images (at most 1,000 and, after one Set add, at most 3,499) as full Asset objects in items, in List order. owner is {id, username}; subscriberCount is embedded and refreshes hourly, and Like counts are not served. Private, unknown or deleted Lists return 404 (stored at the edge for 24 hours, never by the browser). Responses are stored but revalidated with the ETag.
Path parameters
idstring requiredThe List's ID (a lowercase UUID).
pattern
Responses
200 The List.application/json
Headers
ETagstringValidator, weak (
W/) when the response is compressed. Send it back unchanged asIf-None-Matchto receive304.Cache-ControlstringBrowser caching policy.
"public, no-cache"
dataobjectShow options
One of
kind = "assetList"
kindstring"assetList"idstring (uuid)namestringdescriptionstring | nullownerobjectShow child attributes
idstring (uuid)usernamestringmin length 1
itemCountintegermin 0subscriberCountintegermin 0createdAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternupdatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternitemsarray of objectShow item attributes
idstring (uuid)extensionstringpattern ^[a-z0-9]{2,5}$slotstring"poster""backdrop""logo""squareArt""titlecard""thumb""cover""hero""wideCover""background""squareCover""icon"entityobjectShow child attributes
kindstringidintegerpositive
languagestring | nullISO 639-1 code;
xxis textless.pattern ^[a-z]{2}$editionstring | null"theatricalCut""directorsCut""extendedCut""unratedCut""imaxVersion""criterionEdition""finalCut""fanEdit""producersCut""alternateColorGrading"widthintegerpositiveheightintegerpositivefileSizeintegermin 0setobject | nullShow child attributes
kindstring"showSet""movieSet""collectionSet""gameSet""talentSet""brandSet""categorySet"idintegerpositive
creatorobjectShow child attributes
idstring (uuid)usernamestringmin length 1
createdAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternupdatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.pattern
Option 2
kindstring"mediaList""gameList"idstring (uuid)namestringdescriptionstring | nullownerobjectShow child attributes
idstring (uuid)usernamestringmin length 1
itemCountintegermin 0subscriberCountintegermin 0createdAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternupdatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patterntitlesarray of objectShow item attributes
entityobjectShow child attributes
idintegerpositivetitlestringyearinteger | nullmin 1max 9999kindstring"show""season""episode""movie""collection""person""network""company""category""game"
positionintegermin 0posterobject | nullShow child attributes
idstring (uuid)extensionstringpattern ^[a-z0-9]{2,5}$languagestring | nullISO 639-1 code;
xxis textless.pattern ^[a-z]{2}$editionstring | null"theatricalCut""directorsCut""extendedCut""unratedCut""imaxVersion""criterionEdition""finalCut""fanEdit""producersCut""alternateColorGrading"widthintegerpositiveheightintegerpositivefileSizeintegermin 0setobject | nullShow child attributes
kindstring"showSet""movieSet""collectionSet""gameSet""talentSet""brandSet""categorySet"idintegerpositive
creatorobjectShow child attributes
idstring (uuid)usernamestringmin length 1
createdAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternupdatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.pattern
choiceCountintegermin 0updatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.pattern
If-None-Match validator still matches; no body.400 The path is not a valid route, or the request carried a query string or body.application/json
Headers
Cache-ControlstringBrowser caching policy.
"no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
404 The resource does not exist or is not public.application/json
Headers
Cache-ControlstringBrowser caching policy.
"no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
405 Only GET, HEAD and OPTIONS are supported.application/json
Headers
Cache-ControlstringBrowser caching policy.
"no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
429 Too many cache misses from this address. Retry after the Retry-After delay.application/json
Headers
Cache-ControlstringBrowser caching policy.
"no-store"Retry-AfterstringSeconds to wait before trying again.
pattern ^\d+$
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
503 Temporarily unavailable. Retry after the Retry-After delay.application/json
Headers
Cache-ControlstringBrowser caching policy.
"no-store"Retry-AfterstringSeconds to wait before trying again.
pattern ^\d+$
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.