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

# List Company Contacts

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

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

List contacts for a company with filtering options.

Args:
    company_uuid (UUID): The company UUID.
    db_session (DBSessionDep): Database session dependency.
    selected (bool, optional): Filter by selection status.
    search (str, optional): Search term for contact name, department or position (role).
    search_name (str, optional): Search term for contact name only.
    user_uuid (UUID, optional): Filter by contact owner.
    organization_uuid (List[UUID], optional): Filter by organization UUID(s).
    organization_type (List[TypeEnum], optional): Filter by organization type(s).
    country_id (List[int], optional): Filter by country ID(s).
    position (str, optional): Filter by contact position using fuzzy matching.
    department (str, optional): Filter by contact department using fuzzy matching.
    sort_by (str, optional): Sort by field ('name', 'first_interaction', 'last_interaction', 'total_interactions_count', 'sentiment_score').
    sort_order (str, optional): Sort order ('asc' or 'desc').

Returns:
    Page[CompanyContactResponse]: Paginated list of contacts.

## Path parameters

- `company_uuid` string, uuid, required

## Query parameters

- `selected` boolean, nullable: Filter by selection status
- `search` string, nullable: Search term for contact name or position (role)
- `search_name` string, nullable: Search term for contact name only
- `user_uuid` string, uuid, nullable: Filter by contact owner
- `organization_uuid` string[], nullable: Filter by organization UUID(s). Can specify multiple times.
- `organization_type` TypeEnum[], nullable: Filter by organization type. Can specify multiple times.
- `country_id` integer[], nullable: Filter by country ID(s). Can specify multiple times.
- `position` string, nullable: Filter by contact position
- `department` string, nullable: Filter by contact department
- `regdoor_verified` boolean, nullable: Filter by regdoor verified status
- `collection_list` string[]: Filter by collection name(s). Can specify multiple times.
- `group_uuid` string[]: Filter by area (group) via collections owned by these groups.
- `sort_by` string, nullable: Sort by field (name, first_interaction, last_interaction, total_interactions_count, sentiment_score)
- `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

- PageCompanyContactResponse
  - `items` CompanyContactResponse[], required
    - `name` string, required
    - `email` string
    - `info` object, required
    - `uuid` string, uuid4, required
    - `avatar_file_name` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `deleted_at` string, date-time, nullable
    - `company_data` ContactCompanyData[], 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'
      - `visibility` string
      - `personal_owner_user_uuid` string, uuid4, nullable
    - `organizations` ContactOrganization[], required
      - `uuid` string, uuid4, required
      - `name` string, required
      - `short_name` string, nullable
      - `country` ContactCountry, required
        - `id` integer, required
        - `name` string, required
        - `code` string, required
      - `type` string, required
    - `experiences` ContactExperience[]
      - `uuid` string, uuid4, nullable
      - `organization` ContactOrganization, required
        - `uuid` string, uuid4, required
        - `name` string, required
        - `short_name` string, nullable
        - `country` ContactCountry, required
          - `id` integer, required
          - `name` string, required
          - `code` string, required
        - `type` string, required
      - `role` string
      - `info` object
      - `start_date` string, date, nullable
      - `end_date` string, date, nullable
    - `owners` UserBase[], required
      - `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` ContactGroupSummary[]
      - `uuid` string, uuid4, required
      - `name` string, required
    - `contents` ContentLite[]
      - `uuid` string, uuid4, required
      - `name` string, required
      - `released_at` string, date-time, nullable
      - `type` string, nullable
      - `is_global_link` boolean
    - `avatar_url` string, nullable, required
    - `is_private` boolean, required: Whether this contact is private (belongs to a specific company)
    - `is_selected` boolean, required: Whether this contact is selected for the company
  - `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)