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

# List Companies

> Previous version of List Workspaces. Retrieve authorized companies.

<Warning>
  Previous API version. Use [`GET /workspaces`](/api-reference/workspaces/list-workspaces) for new integrations. This route still works but is deprecated.
</Warning>

Retrieve all companies (now called workspaces) that the authenticated user has authorized your application to access.

```text theme={null}
GET https://connect.penbox.io/v1/companies
```

## Response

<Warning>
  Unlike the current `GET /workspaces` endpoint, this route returns a **bare JSON array** with no pagination `meta` envelope.
</Warning>

```json theme={null}
[
  {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "created_at": "2024-01-15T10:30:00Z",
    "slug": "acme-corp",
    "name": "Acme Corp"
  }
]
```

The `slug` is a URL-safe, unique identifier used in API calls to specify which workspace you want to interact with.

## Example

```bash cURL theme={null}
curl 'https://connect.penbox.io/v1/companies' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

## Response Codes

| Code  | Description                          |
| ----- | ------------------------------------ |
| `200` | Success — returns array of companies |
| `401` | Unauthorized                         |
| `403` | Forbidden                            |
| `429` | Too Many Requests                    |
| `500` | Server Error                         |