---
title: "Season Credits"
method: GET
path: "/svm/tv_shows/{id}/seasons/{season}/credits"
tags: ["TV Shows"]
---

# Season Credits

`GET /svm/tv_shows/{id}/seasons/{season}/credits`

## Request

- Base URL: `https://api.luminatedata.com`
- URL: `https://api.luminatedata.com/svm/tv_shows/{id}/seasons/{season}/credits`
- Auth: API key in header `x-api-key` and API key in header `authorization`

Retrieves the talent credited on one season of a TV show and the roles they held, top-billed first. A talent appears once, holding every role they held on the season.

## Path parameters

- `id` string, required
- `season` string, required

## Query parameters

- `from` integer
- `size` integer

## Response `200`

OK

- SuccessfulResponseTitleCreditsResponse
  - `data` TitleCreditsResponse
    - `title_id` string: Unique Luminate ID assigned to the title
    - `title` string: Name of the title
    - `season` string: ID of the season the credits belong to. Only provided for a single season.
    - `from` integer: Requested offset from the first credit, used for pagination
    - `size` integer: Requested number of credits to return, used for pagination
    - `total_credits` integer: Total number of credits on the title before pagination is applied. A credit is one talent.
    - `credits` TitleCredit[]: The requested page of credits, top-billed first. Each talent appears once.
      - `talent_id` string: Unique Luminate ID assigned to the talent
      - `name` string: Full name of the talent
      - `roles` CreditRole[]: The roles the talent held on this title. A talent can hold more than one, except on the series credits endpoint, which returns only their most prominent role.
        - `role_group` 'cast': Broad category the role belongs to. Only acting credits are currently available, so this is always 'cast'.
        - `role_title` string: The specific role the talent held on the title
        - `character_name` string: Name of the character the talent played
        - `main_title_order` integer: Billing position of the talent in the title's main credits. Only provided for movies, and only where the order is known.

## Other responses

- `400`: Issue with client request
- `404`: Resource not found

---

[API](https://skmtc.dev/luminatedata/apis/luminate-svm-api.md) - [All operations](https://skmtc.dev/luminatedata/apis/luminate-svm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/luminatedata/apis/luminate-svm-api/revisions/ff683b83f008?raw)