# List company attributes

> Returns the custom attributes defined on your team's companies, paginated, including the ones synced from your CRM integrations. Archived attributes are not…

`GET /v2/api/crm/companies/attributes`

<Note>
**Required scope:** `CRM_READ`
</Note>

Returns the custom attributes defined on your team's companies. The list includes the attributes you created and the ones synced from your CRM integrations. Archived attributes are not listed.

## Query parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `page` | integer | `1` | Page number, starting at 1 |
| `size` | integer | `20` | Items per page, from 1 to 100 |

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `key` | string | Unique key of the attribute |
| `label` | string or null | Display name |
| `type` | string or null | `TEXT`, `NUMBER`, `DATE`, `BOOLEAN` or `DROPDOWN` |
| `options` | array or null | `{ key, label }` objects. Only set for `DROPDOWN` |
| `is_visible` | boolean | Whether the attribute is shown in the Allo apps |
| `prompt` | string or null | Instruction the AI CRM Manager uses to fill the attribute from calls |
| `should_prompt_override` | boolean or null | Whether the AI may overwrite an existing value |
| `source` | string | `allo`, or the integration that manages the attribute, such as `hubspot` |
| `created_at` | string | ISO 8601 date-time |
| `updated_at` | string | ISO 8601 date-time |

```json
{
  "data": [
    {
      "key": "employees",
      "label": "Employees",
      "type": "NUMBER",
      "options": null,
      "is_visible": true,
      "prompt": null,
      "should_prompt_override": null,
      "source": "hubspot",
      "created_at": "2026-10-07T14:21:08",
      "updated_at": "2026-10-07T14:21:08"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total_count": 1,
    "total_pages": 1,
    "has_more": false
  }
}
```

## Errors

| Status | Code | When |
|--------|------|------|
| `400` | `INVALID_PAGE_SIZE` | `page` is below 1, or `size` is outside 1 to 100 |
| `403` | `API_KEY_INSUFFICIENT_SCOPE` | The key does not hold `CRM_READ` |
| `404` | `TEAM_NOT_FOUND` | The workspace is not on the new contact model |
