Titles

Generated titles operations.

GET/v1/titlesList titles of one kind in one library, or find a title by its provider idread

Audience: Integrations · Native API
Authorization: API key or personal access token with the read scope, or a signed-in session
OpenAPI operation ID: query_titles

Parameters

Name	In	Type
`library`	query	`string`
`kind`	query	`string`
`sort`	query	`string`
`order`	query	`string`
`yearFrom`	query	`string`
`yearTo`	query	`string`
`addedAfter`	query	`string`
`addedBefore`	query	`string`
`provider`	query	`string`
`providerId`	query	`string`
`cursor`	query	`string`
`limit`	query	`integer \| ""`1–100

Responses

200Successapplication/json

Example

{
  "items": [
    {
      "addedAt": "2026-10-18T19:30:00Z",
      "available": true,
      "durationMs": 1800000,
      "id": "id_8h2k4q",
      "kind": "string",
      "libraryId": "id_8h2k4q",
      "posterUrl": "https://example.com/…",
      "providerIds": {
        "key": "string"
      },
      "rating": 0,
      "title": "Fargo",
      "year": 0
    }
  ],
  "limit": 0,
  "nextCursor": "eyJvIjoyMH0"
}

Schema

itemsarray of objectrequired
- addedAtstring
- availablebooleanrequired
- durationMsinteger≥ 0
- idstringrequired
- kindstringrequired
- libraryIdstringrequired
- posterUrlstring
- providerIdsobjectrequired
- ratingnumber
- titlestringrequired
- yearinteger
limitintegerrequired
nextCursorstring

defaultRequest refused or unavailableapplication/json

Example

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Schema

errorobjectrequired
- codestringrequired
- messagestringrequired

Error codesunauthorizedinvalid_requestinvalid_cursorcursor_expirednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/titles" \
  -H "Authorization: Bearer $PORTICO_API_KEY"