---
title: "Get a Country"
method: GET
path: "/countries/{country-code}"
tags: ["countries"]
---

# Get a Country

`GET /countries/{country-code}`

Get a country and the list of the supported services and their details.

Details of services include names, logos, supported streaming types (subscription, rent, buy, free etc.) and list of available addons/channels.

## Path parameters

- `country-code` string, required

## Query parameters

- `output_language` 'en' | 'es' | 'tr' | 'fr'

## Response `200`

Details of a country.

- Country — Countries are the primary way to get the supported streaming services and addons (such as list of available Apple TV and Prime Video channels) in a region. Each country object contains the country code, name and the list of supported streaming services. Details of the streaming services include localized logos, homepages, theme colors, and available streaming options and addons.
  - `countryCode` string, required — [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the country.
  - `name` string, required — Name of the country.
  - `services` Service[], required — Array of the supported services in the country, ordered by popularity.
    - `id` string, required — Id of the service.
    - `name` string, required — Name of the service.
    - `homePage` string, required — Link to the homepage of the service.
    - `themeColorCode` string, required — Associated theme color hex code of the service.
    - `imageSet` ServiceImageSet, required — Image set of a service or an addon.
      - `lightThemeImage` string, required — Link to the logo suitable for light themed background.
      - `darkThemeImage` string, required — Link to the logo suitable for dark themed background.
      - `whiteImage` string, required — Link to the logo that is all white.
    - `streamingOptionTypes` StreamingOptionTypes, required — Availability of the streaming option types in the service.
      - `addon` boolean, required — Whether there are shows available via an addon/channel subscription.
      - `buy` boolean, required — Whether there are shows available to buy.
      - `rent` boolean, required — Whether there are shows available for rental.
      - `free` boolean, required — Whether there are free shows to watch.
      - `subscription` boolean, required — Whether there are shows available via a paid subscription plan.
    - `addons` Addon[], required — Array of the supported addons in the service.
      - `id` string, required — Id of the addon.
      - `name` string, required — Name of the addon.
      - `homePage` string, required — Link to the homepage of the addon.
      - `themeColorCode` string, required — Associated theme color hex code of the addon.
      - `imageSet` ServiceImageSet, required — Image set of a service or an addon.
        - `lightThemeImage` string, required — Link to the logo suitable for light themed background.
        - `darkThemeImage` string, required — Link to the logo suitable for dark themed background.
        - `whiteImage` string, required — Link to the logo that is all white.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/myangel-ai/apis/streaming-availability-api.md) · [All operations](https://skmtc.net/myangel-ai/apis/streaming-availability-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myangel-ai/streaming-availability-api/revisions/16fa35a29f15/schema)