---
title: "GET /search/remoteid/{remoteId}"
method: GET
path: "/search/remoteid/{remoteId}"
tags: ["Search"]
---

# GET /search/remoteid/{remoteId}

`GET /search/remoteid/{remoteId}`

Search a series, movie, people, episode, company or season by specific remote id and returns a base record for that entity.

## Path parameters

- `remoteId` string, required

## Response `200`

response

- object
  - `data` SearchByRemoteIdResult[]
    - `series` SeriesBaseRecord — The base record for a series. All series airs time like firstAired, lastAired, nextAired, etc. are in US EST for US series, and for all non-US series, the time of the show’s country capital or most populous city. For streaming services, is the official release time. See https://support.thetvdb.com/kb/faq.php?id=29.
      - `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.
      - `averageRuntime` integer, nullable
      - `country` string
      - `defaultSeasonType` integer
      - `episodes` EpisodeBaseRecord[]
        - `absoluteNumber` integer
        - `aired` string
        - `airsAfterSeason` integer
        - `airsBeforeEpisode` integer
        - `airsBeforeSeason` integer
        - `finaleType` string — season, midseason, or series
        - `id` integer
        - `image` string
        - `imageType` integer, nullable
        - `isMovie` integer
        - `lastUpdated` string
        - `linkedMovie` integer
        - `name` string
        - `nameTranslations` string[]
        - `number` integer
        - `overview` string
        - `overviewTranslations` string[]
        - `runtime` integer, nullable
        - `seasonNumber` integer
        - `seasons` SeasonBaseRecord[]
          - `id` integer
          - `image` string
          - `imageType` integer
          - `lastUpdated` string
          - `name` string
          - `nameTranslations` string[]
          - `number` integer
          - `overviewTranslations` string[]
          - `companies` Companies — Companies by type record
            - `studio` Company[]
              - …
            - `network` Company[]
              - …
            - `production` Company[]
              - …
            - `distributor` Company[]
              - …
            - `special_effects` Company[]
              - …
          - `seriesId` integer
          - `type` SeasonType — season type record
            - `alternateName` string
            - `id` integer
            - `name` string
            - `type` string
          - `year` string
        - `seriesId` integer
        - `seasonName` string
        - `year` string
      - `firstAired` string
      - `id` integer
      - `image` string
      - `isOrderRandomized` boolean
      - `lastAired` string
      - `lastUpdated` string
      - `name` string
      - `nameTranslations` string[]
      - `nextAired` string
      - `originalCountry` string
      - `originalLanguage` string
      - `overviewTranslations` string[]
      - `score` number, double
      - `slug` string
      - `status` Status — status record
        - `id` integer, nullable
        - `keepUpdated` boolean
        - `name` string
        - `recordType` string
      - `year` string
    - `people` PeopleBaseRecord — base people record
      - `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
      - `lastUpdated` string
      - `name` string
      - `nameTranslations` string[]
      - `overviewTranslations` string[]
      - `score` integer
    - `movie` MovieBaseRecord — base movie record
      - `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
      - `lastUpdated` string
      - `name` string
      - `nameTranslations` string[]
      - `overviewTranslations` string[]
      - `score` number, double
      - `slug` string
      - `status` Status — status record
        - `id` integer, nullable
        - `keepUpdated` boolean
        - `name` string
        - `recordType` string
      - `runtime` integer, nullable
      - `year` string
    - `episode` EpisodeBaseRecord — base episode record
      - `absoluteNumber` integer
      - `aired` string
      - `airsAfterSeason` integer
      - `airsBeforeEpisode` integer
      - `airsBeforeSeason` integer
      - `finaleType` string — season, midseason, or series
      - `id` integer
      - `image` string
      - `imageType` integer, nullable
      - `isMovie` integer
      - `lastUpdated` string
      - `linkedMovie` integer
      - `name` string
      - `nameTranslations` string[]
      - `number` integer
      - `overview` string
      - `overviewTranslations` string[]
      - `runtime` integer, nullable
      - `seasonNumber` integer
      - `seasons` SeasonBaseRecord[]
        - `id` integer
        - `image` string
        - `imageType` integer
        - `lastUpdated` string
        - `name` string
        - `nameTranslations` string[]
        - `number` integer
        - `overviewTranslations` string[]
        - `companies` Companies — Companies by type record
          - `studio` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
          - `network` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
          - `production` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
          - `distributor` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
          - `special_effects` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
        - `seriesId` integer
        - `type` SeasonType — season type record
          - `alternateName` string
          - `id` integer
          - `name` string
          - `type` string
        - `year` string
      - `seriesId` integer
      - `seasonName` string
      - `year` string
    - `company` Company — A company record
      - `activeDate` string
      - `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.
      - `country` string
      - `id` integer
      - `inactiveDate` string
      - `name` string
      - `nameTranslations` string[]
      - `overviewTranslations` string[]
      - `primaryCompanyType` integer, nullable
      - `slug` string
      - `parentCompany` ParentCompany — A parent company record
        - `id` integer, nullable
        - `name` string
        - `relation` CompanyRelationShip — A company relationship
          - `id` integer, nullable
          - `typeName` string
      - `tagOptions` TagOption[]
        - `helpText` string
        - `id` integer
        - `name` string
        - `tag` integer
        - `tagName` string
  - `status` string

## Other responses

- `401` — Unauthorized

---

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