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

# List Company Organizations

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

## 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}/organizations`
- Auth: HTTP bearer

List organizations for a company with optional filtering.

Args:
    company_uuid (UUID): The company UUID.
    db_session (DBSessionDep): Database session dependency.
    type (str, optional): Filter by organization type.
    search (str, optional): Search by organization name.
    country_id (List[int], optional): Filter by country ID(s).
    selected (bool, optional): Filter by selection status.
    user_uuid (UUID, optional): Filter by organization owner.
    sort_by (str, optional): Sort by field ('name', 'short_name', or 'country').
    sort_order (str, optional): Sort order ('asc' or 'desc').

Returns:
    Page[CompanyOrganizationResponse]: Paginated list of organizations.

## Path parameters

- `company_uuid` string, uuid, required

## Query parameters

- `type` string, nullable: Filter by organization type
- `search` string, nullable: Search by organization name
- `country_id` integer[], nullable: Filter by country ID(s). Can specify multiple times.
- `selected` boolean, nullable: Filter by selection status
- `user_uuid` string, uuid, nullable: Filter by organization owner
- `collection_list` string[]: Filter by collection name(s). Can specify multiple times.
- `group_uuid` string[]: Filter by company group UUID(s). Can specify multiple times.
- `government_body_type` GovernmentBodyTypeEnum[], nullable: Filter government bodies by role. Match if the org has any selected role.
- `service_provider_type` ServiceProviderTypeEnum[], nullable: Filter by service provider subtype. Match if the org has any selected subtype.
- `regulatory_scope` RegulatoryScopeEnum[], nullable: Filter by regulatory scope tags. capital_markets matches any child scope.
- `regulatory_power` RegulatoryPowerEnum[], nullable: Filter by regulatory power tags. Match if the org has any selected power.
- `institutional_form` InstitutionalFormEnum[], nullable: Filter by institutional form. Match if the org has any selected form.
- `group_uuid_list` string[], nullable: Filter by responsible area (group). Match if the org has any of them.
- `unassigned_group` boolean: Only selected organizations without any area. Combined with group_uuid_list returns the union.
- `sort_by` string, nullable: Sort by field (name, short_name, first_interaction, last_interaction, total_interactions_count, sentiment_score, contacts_total, or country)
- `sort_order` string, nullable: Sort order (asc or desc)
- `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

- PageCompanyOrganizationResponse
  - `items` CompanyOrganizationResponse[], required
    - `name` string, required
    - `type` 'association' | 'government_body' | 'service_provider' | 'political_party', required
    - `short_name` string, nullable
    - `description` string, nullable
    - `info` object, nullable
    - `sentiment` string, nullable
    - `parent_organization_uuids` 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
    - `government_body_types` GovernmentBodyTypeEnum[]
    - `service_provider_types` ServiceProviderTypeEnum[]
    - `uuid` string, uuid4, required
    - `company_data` OrganizationCompanyData[], required
      - `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
      - `visibility` string
      - `personal_owner_user_uuid` string, uuid4, nullable
    - `is_private` boolean, required
    - `is_selected` boolean: Whether this organization is selected for the company
    - `country` OrganizationCountry, required: Schema for countries that are associated with an organization
      - `id` integer, required
      - `name` string, required
    - `owners` UserBase[]: List of owners from the requesting company
      - `uuid` string, uuid4, required
      - `name` string, required
      - `phone_number` string, nullable
      - `email` string, email, required
      - `avatar_file_name` string, nullable
      - `ui_language` 'en' | 'pt' | 'es', nullable
      - `avatar_url` string, nullable, required: Get the avatar URL based on the filename if one exists
    - `collections` string[]
    - `groups` OrganizationGroupSummary[]: Áreas responsáveis pela organização na company
      - `uuid` string, uuid4, required
      - `name` string, required
    - `parents` OrganizationParentSummary[]
      - `uuid` string, uuid4, required
      - `name` string, required
      - `short_name` string, nullable
      - `type` 'association' | 'government_body' | 'service_provider' | 'political_party', required
      - `is_private` boolean, required
  - `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)