> ## Documentation Index
> Fetch the complete documentation index at: https://www.orwel.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Companies

> Retrieve a paginated list of companies

> [!NOTE]
>
> Requires an [API key](https://www.orwel.io/docs/authentication.md) (`orwel_sk_`) with the `companies:read` scope.

## Query Parameters

**limit** `integer` (default: 50)

Maximum number of results to return (max: 100)

**offset** `integer` (default: 0)

Number of results to skip for pagination

**name** `string`

Filter companies by name (partial match)

**domain** `string`

Filter companies by domain (exact match)

## Response

**data** `array`

Array of company objects

**Company Object**

**id** `string`

Unique identifier for the company

**name** `string`

Company name

**domain** `string`

Company domain

**description** `string`

Description

**employees** `string`

Number of employees

**main\_industry** `string`

Main industry

**created\_at** `string`

ISO 8601 timestamp of creation

**pagination** `object`

Pagination information

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

```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
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.