> ## Documentation Index
> Fetch the complete documentation index at: https://orwel-22af1265.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Companies

> Retrieve a paginated list of companies

## Query Parameters

<ParamField query="limit" type="integer" default="50">
  Maximum number of results to return (max: 100)
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of results to skip for pagination
</ParamField>

<ParamField query="name" type="string">
  Filter companies by name (partial match)
</ParamField>

<ParamField query="domain" type="string">
  Filter companies by domain (exact match)
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of company objects

  <Expandable title="Company Object">
    <ResponseField name="id" type="string">
      Unique identifier for the company
    </ResponseField>

    <ResponseField name="name" type="string">
      Company name
    </ResponseField>

    <ResponseField name="domain" type="string">
      Company domain
    </ResponseField>

    <ResponseField name="description" type="string">
      Description
    </ResponseField>

    <ResponseField name="employees" type="string">
      Number of employees
    </ResponseField>

    <ResponseField name="main_industry" type="string">
      Main industry
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of creation
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination information
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.orwel.io/api/v1/companies?limit=10" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "company-uuid",
        "name": "Acme Corp",
        "domain": "acme.com",
        "description": "Leading provider of widgets",
        "employees": "100-500",
        "main_industry": "Manufacturing",
        "created_at": "2025-01-01T00:00:00Z"
      }
    ],
    "pagination": {
      "limit": 10,
      "offset": 0,
      "total": 50
    }
  }
  ```
</ResponseExample>