---
title: "Talent Credits"
method: GET
path: "/svm/talent/{id}/credits"
tags: ["Talent"]
---

# Talent Credits

`GET /svm/talent/{id}/credits`

## Request

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

Retrieves the titles a talent is credited on and the roles they held. A TV show contributes one credit per credited season, and a talent can hold more than one role on the same title.

## Path parameters

- `id` string, required

## Query parameters

- `video_type` 'movie' | 'tv_show'
- `start_date` string, date
- `end_date` string, date
- `from` integer
- `size` integer

## Response `200`

OK

- SuccessfulResponseTalentCreditsResponse
  - `data` TalentCreditsResponse
    - `talent_id` string: Unique Luminate ID assigned to the talent
    - `talent_name` string: Full name of the talent
    - `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 matching the request before pagination is applied. A credit is one title, or one season of a TV show.
    - `credits` TalentCredit[]: The requested page of credits, most recently released first. TV shows contribute one credit per credited season.
      - `title_id` string: Unique Luminate ID assigned to the title
      - `title` string: Name of the title
      - `video_type` 'movie' | 'tv_show': Type of video content, either 'movie' or 'tv_show'
      - `release_date` string, date: Date the title was released, formatted according to the ISO 8601 date standard (YYYY-MM-DD)
      - `season` string: ID of the season the credit belongs to. Only provided for TV shows.
      - `roles` CreditRole[]: Every role the talent held on this title or season. A talent can hold more than one.
        - `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)