# List companies

Retrieve a paginated list of companies in your CRM. Supports filtering by name, domain, industry, and other fields.

Endpoint: GET /leads/api/companies
Version: 2.0.0
Security: bearerAuth

## Query parameters:

  - `limit` (integer)
    Items per page (default 20).
    Example: 20

  - `offset` (integer)
    Items to skip (default 0).

  - `order_field` (string)
    Sort field (default created_at).
    Example: "created_at"

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

  - `filter` (object)
    Filters for company search.

## Response 200 fields (application/json):

  - `data` (array)

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

  - `data.team_id` (integer)

  - `data.user_id` (integer,null)

  - `data.data_source_uuid` (string,null)

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

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

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

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

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

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

  - `data.facebook` (string,null)

  - `data.twitter` (string,null)

  - `data.phone` (string,null)

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

  - `data.hq_location` (array,null)

  - `data.logo_url` (string,null)

  - `data.industry` (string,null)
    Example: "Technology"

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

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

  - `data.about` (string,null)

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

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

  - `data.status` (string)

  - `data.last_enrich_at` (string,null)

  - `data.created_at` (string,null)

  - `data.updated_at` (string,null)

  - `limit` (integer)
    Example: 20

  - `offset` (integer)

  - `total` (integer)
    Example: 58