# Search companies

Search and filter companies with pagination. Same filtering capabilities as `GET /leads/api/companies` but as a POST so you can pass complex `filter` objects in the request body instead of query strings.

Endpoint: POST /leads/api/companies/list
Version: 2.0.0
Security: bearerAuth

## Request fields (application/json):

  - `filter` (object)
    Filter criteria. Same shape as `GET /leads/api/companies` filter.
    Example: {"industry":"SaaS"}

  - `limit` (integer)
    Example: 20

  - `offset` (integer)
    Example: 0

  - `order_field` (string)

  - `order_type` (string)
    Enum: "asc", "desc"

## Response 200 fields (application/json):

  - `data` (array)

  - `data.uuid` (string)
    Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

  - `data.team_id` (integer)

  - `data.user_id` (integer)

  - `data.data_source_uuid` (string)

  - `data.lead_status_uuid` (string)
    Pipeline stage UUID.

  - `data.name` (string)
    Example: Acme Inc

  - `data.domain` (string)
    Example: acme.com

  - `data.website` (string)
    Example: https://acme.com

  - `data.ln_id` (integer)
    LinkedIn company numeric ID.

  - `data.linkedin` (string)
    Example: acme-inc

  - `data.facebook` (string)

  - `data.twitter` (string)

  - `data.phone` (string)

  - `data.hq_raw_address` (string)
    Example: San Francisco, CA, USA

  - `data.hq_location` (array)

  - `data.logo_url` (string)

  - `data.industry` (string)
    Example: Technology

  - `data.employees_range` (string)
    Example: 51-200

  - `data.year_established` (integer)
    Example: 2015

  - `data.about` (string)

  - `data.lists` (array)
    List UUIDs.

  - `data.tags` (array)
    Tag UUIDs.

  - `data.status` (string)

  - `data.last_enrich_at` (string)

  - `data.created_at` (string)

  - `data.updated_at` (string)

  - `limit` (integer)

  - `offset` (integer)

  - `total` (integer)

  - `has_more` (boolean)

## Response 422 fields (application/json):

  - `error` (object)

  - `error.reason` (string)
    Machine-readable error code: `validation_error`, `bad_request`, `auth_exception`, `access_denied`, `payment_required`.
    Example: validation_error

  - `error.message` (string)
    Example: The name field is required.

  - `message` (string)
    Example: The given data was invalid.

  - `code` (integer)
    Example: 422