---
title: "List Company Countries"
method: GET
path: "/api/companies/{company_uuid}/countries"
tags: ["company-countries"]
---

# List Company Countries

`GET /api/companies/{company_uuid}/countries`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/countries`
- Auth: HTTP bearer

List countries for a company.

Args:
    company_uuid (UUID): The company UUID.
    db_session (DBSessionDep): Database session dependency.
    search (str, optional): Search term for country name or code.
    selected (bool, optional): If True, only selected countries for the company are returned.
    entitled (bool, optional): If set, only released or only unreleased countries.
    user_uuid (UUID, optional): Filter by countries whose areas intersect
        the user's groups.
    sort_by (str, optional): Field to sort by ('name' or 'code').
    sort_order (str, optional): Sort order ('asc' or 'desc').
    ids (List[int], optional): Filter by specific country IDs.

Returns:
    Page[Country]: Paginated list of countries.

## Path parameters

- `company_uuid` string, uuid, required

## Query parameters

- `search` string, nullable
- `selected` boolean, nullable
- `entitled` boolean, nullable
- `user_uuid` string, uuid, nullable
- `sort_by` string, nullable: Sort by field (name, code, first_interaction, last_interaction, total_interactions_count, sentiment_score, service_providers_total, associations_total, government_bodies_total)
- `sort_order` string, nullable: Sort order (asc or desc)
- `ids` integer[], nullable: Filter by specific country IDs
- `page` integer: Page number
- `size` integer: Page size

## Headers

- `X-Teamspace-Uuid` string, uuid, nullable
- `X-User-Email` string, nullable
- `X-User-Name` string, nullable

## Response `200`

Successful Response

- PageCountry
  - `items` AppViewsCompanyCountriesSchemaCountry[], required
    - `code` string, required
    - `name` string, required
    - `description` string, nullable
    - `id` integer, required
    - `company_uuid` string, uuid, nullable
    - `company_data` CountryCompanyData[]
      - `first_interaction` string, date-time, nullable
      - `last_interaction` string, date-time, nullable
      - `total_interactions_count` integer, nullable
      - `sentiment_score` integer, nullable
      - `sentiment_variation` 'positive' | 'negative' | 'neutral'
      - `contacts_total` integer, nullable
      - `service_providers_total` integer, nullable
      - `associations_total` integer, nullable
      - `government_bodies_total` integer, nullable
    - `languages` string[], nullable
    - `first_interaction` string, date-time, nullable
    - `last_interaction` string, date-time, nullable
    - `total_interactions_count` integer, nullable
    - `sentiment_score` integer, nullable
    - `sentiment_variation` 'positive' | 'negative' | 'neutral'
    - `contacts_total` integer, nullable
    - `service_providers_total` integer, nullable
    - `associations_total` integer, nullable
    - `government_bodies_total` integer, nullable
    - `owners` CountryUser[], required
      - `uuid` string, uuid4, required
      - `name` string, required
    - `groups` CountryGroup[]
      - `uuid` string, uuid4, required
      - `name` string, required
    - `associations` CountryOrganization[]
      - `uuid` string, uuid4, required
      - `name` string, required
      - `short_name` string, nullable
      - `type` string, required
      - `country_id` integer, required
      - `companies` CountryCompany[]
        - `uuid` string, uuid4, required
        - `name` string, required
      - `contacts` OrganizationContact[]
        - `uuid` string, uuid4, required
        - `name` string, required
      - `is_private` boolean, required
      - `government_body_types` string[]
      - `service_provider_types` string[]
      - `first_interaction_date` string, date-time, nullable
      - `last_interaction_date` string, date-time, nullable
      - `total_interactions` integer
    - `government_bodies` CountryOrganization[]
      - `uuid` string, uuid4, required
      - `name` string, required
      - `short_name` string, nullable
      - `type` string, required
      - `country_id` integer, required
      - `companies` CountryCompany[]
        - `uuid` string, uuid4, required
        - `name` string, required
      - `contacts` OrganizationContact[]
        - `uuid` string, uuid4, required
        - `name` string, required
      - `is_private` boolean, required
      - `government_body_types` string[]
      - `service_provider_types` string[]
      - `first_interaction_date` string, date-time, nullable
      - `last_interaction_date` string, date-time, nullable
      - `total_interactions` integer
    - `service_providers` CountryOrganization[]
      - `uuid` string, uuid4, required
      - `name` string, required
      - `short_name` string, nullable
      - `type` string, required
      - `country_id` integer, required
      - `companies` CountryCompany[]
        - `uuid` string, uuid4, required
        - `name` string, required
      - `contacts` OrganizationContact[]
        - `uuid` string, uuid4, required
        - `name` string, required
      - `is_private` boolean, required
      - `government_body_types` string[]
      - `service_provider_types` string[]
      - `first_interaction_date` string, date-time, nullable
      - `last_interaction_date` string, date-time, nullable
      - `total_interactions` integer
    - `deleted` boolean
    - `is_entitled` boolean
    - `info` object, nullable
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)