# Get Contacts by Company

Retrieve contacts for a specific company using its ID or Registration Number.

Endpoint: GET /contacts/company/{company_id}
Version: 1.0.0
Security: ApiKeyHeader, ApiKeyQuery

## Path parameters:

  - `company_id` (string, required)
    The internal Company ID OR the official Registration Number (e.g., GB06441592).

## Query parameters:

  - `show_all_anonymized` (boolean)
    If true, returns anonymized preview data (free of charge).

  - `withemail` (boolean)
    Filter Include only contacts with email addresses.

  - `withlinkedin` (boolean)
    Filter Include only contacts with LinkedIn URLs.

  - `withlegal` (boolean)
    Filter Include only legal representatives.

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

  - `contact_max` (integer)
    Maximum number of contacts to return.

  - `contact_ids` (array)
    List of specific Contact IDs to retrieve (overrides filters).

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `company` (object)

  - `company.id` (string)
    Unique company identifier.
    Example: "593b6fa6b3a2feb79d4f9f39"

  - `company.registration_number` (string)
    Official registration number (e.g. SIREN).
    Example: "GB06441592"

  - `contacts` (array)

  - `contacts.id` (string)
    Unique contact identifier (safe string).
    Example: "8301343831281918940"

  - `contacts.civility` (string)
    Example: "Mr"

  - `contacts.first_name` (string)
    Example: "James"

  - `contacts.last_name` (string)
    Example: "THOMPSON"

  - `contacts.role` (string)
    Job title.
    Example: "Chief Technology Officer"

  - `contacts.level_code` (string)
    Enum: "EXECUTIVE", "DIRECTOR", "MANAGER", "SUPERVISOR", "ASSISTANT", "COLLABORATOR", "OTHER"

  - `contacts.level_label` (string)
    Example: "Director"

  - `contacts.domain_code` (string)
    Department/Domain code (any text).
    Example: "TECH"

  - `contacts.domain_label` (string)
    Example: "Technology"

  - `contacts.email` (string)
    Example: "james.thompson@example.com"

  - `contacts.email_test_result` (string)
    Enum: "Safe to Send", "Risky", "Invalid", "Unknown"

  - `contacts.linkedin_url` (string)
    Example: "https://www.linkedin.com/in/james-thompson"

  - `contacts.contact_source` (string)
    Enum: "linkedin", "legal"

  - `contacts.anonymized` (boolean)
    Whether the contact data is masked (preview mode).

  - `contacts_count` (integer)

  - `meta` (object)

  - `meta.has_more` (boolean)

  - `meta.next_cursor` (string,null)

  - `credits_used` (integer)
    Number of credits consumed by this request.

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

  - `success` (boolean)

  - `error` (object)

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

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