---
title: "GET /lists"
method: GET
path: "/lists"
tags: ["Lists"]
---

# GET /lists

`GET /lists`

returns list of list base records

## Query parameters

- `page` number

## Response `200`

response

- object
  - `data` ListBaseRecord[]
    - `aliases` Alias[]
      - `language` string — A 3-4 character string indicating the language of the alias, as defined in Language.
      - `name` string — A string containing the alias itself.
    - `id` integer
    - `image` string
    - `imageIsFallback` boolean
    - `isOfficial` boolean
    - `name` string
    - `nameTranslations` string[]
    - `overview` string
    - `overviewTranslations` string[]
    - `remoteIds` RemoteID[]
      - `id` string
      - `type` integer
      - `sourceName` string
    - `tags` TagOption[]
      - `helpText` string
      - `id` integer
      - `name` string
      - `tag` integer
      - `tagName` string
    - `score` integer
    - `url` string
  - `status` string
  - `links` Links — Links for next, previous and current record
    - `prev` string, nullable
    - `self` string, nullable
    - `next` string
    - `total_items` integer
    - `page_size` integer

## Other responses

- `401` — Unauthorized

## Changes

- **2026-07-17** `5d7caa274c72` — 2 breaking
  - the response property `links/prev` became nullable for the status `200`
  - the response property `links/self` became nullable for the status `200`
- **2022-08-09** `b89486acff84` — 2 info
  - added the optional property `data/items/remoteIds` to the response with the `200` status
  - added the optional property `data/items/tags` to the response with the `200` status
- **2022-08-09** `689bbdea858f` — 2 warning
  - removed the optional property `data/items/remoteIds` from the response with the `200` status
  - removed the optional property `data/items/tags` from the response with the `200` status
- **2022-08-09** `5e67abc676fe` — 2 info
  - added the optional property `data/items/remoteIds` to the response with the `200` status
  - added the optional property `data/items/tags` to the response with the `200` status
- **2022-05-12** `e01e84a26def` — 2 warning
  - removed the optional property `data/items/remoteIds` from the response with the `200` status
  - removed the optional property `data/items/tags` from the response with the `200` status

[Change history](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/changes/lists/get.md)

---

[API](https://skmtc.dev/thetvdb/apis/tvdb-api-v4.md) · [All operations](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thetvdb/tvdb-api-v4/revisions/5d7caa274c72/schema)