# Search Companies

Search for companies containing contacts matching specified criteria (seniority, department, etc.).

Endpoint: GET /companies
Version: 1.0.0
Security: ApiKeyHeader, ApiKeyQuery

## Query parameters:

  - `contact_level_code` (array)
    Filter by contact seniority level(s).
    Enum: "EXECUTIVE", "DIRECTOR", "MANAGER", "SUPERVISOR", "ASSISTANT", "COLLABORATOR", "OTHER"

  - `contact_domain_code` (array)
    Filter by department/domain (e.g., 'IT', 'Marketing', 'Sales'). Supports custom text.

  - `contact_role_query` (string)
    Semantic search query for job titles (e.g., "python developer").

  - `email_test_status` (string)
    Filter by email verification status.
    Enum: "all", "safe", "notsafe"

  - `contact_source` (array)
    Filter by origin of contact data.
    Enum: "linkedin", "legal"

  - `limit` (integer)
    Number of results per page.

  - `cursor` (string)
    Cursor for pagination (obtained from previous response meta).

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `meta` (object)

  - `meta.total` (integer)

  - `meta.limit` (integer)

  - `meta.next_cursor` (string,null)

  - `meta.has_more` (boolean)

  - `data` (array)

  - `data.id` (string)

  - `data.registration_number` (string)

  - `data.contacts_count` (integer)

  - `data.contacts_preview` (array)

  - `data.contacts_preview.role` (string)
    Example: "CTO"

  - `data.contacts_preview.level_code` (string)
    Example: "EXECUTIVE"

  - `data.contacts_preview.domain_code` (string)
    Example: "TECH"

  - `data.contacts_preview.email_test_result` (string)
    Example: "Safe to Send"

  - `data.contacts_preview.anonymized` (boolean)
    Example: true

## Response 400 fields (application/problem+json):

  - `success` (boolean)

  - `error` (object)

  - `error.code` (string)
    Example: "INVALID_PARAMETER"

  - `error.message` (string)
    Example: "Invalid level_code"


## Response 401 fields