# List custom fields

> Returns the custom fields defined on your team's people, paginated. Includes the fields you created with the API and the ones synced from your CRM…

`GET /v2/api/crm/attributes`

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

Returns the custom fields defined on your team's people, oldest first. The list includes the fields you created with the API and the ones synced from your CRM integrations. Deleted (archived) fields and built-in fields such as `name` or `company` 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 |

See [Pagination](/docs/guides/pagination).

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `key` | string | Unique key of the field |
| `label` | string or null | Display name |
| `type` | string or null | `TEXT`, `NUMBER`, `DATE`, `BOOLEAN` or `DROPDOWN` |
| `options` | array | `{ key, label }` objects. Only present for `DROPDOWN` |
| `source` | string | `allo`, or the integration that manages the field, such as `hubspot` |

```json
{
  "data": [
    { "key": "budget", "label": "Budget", "type": "NUMBER", "source": "allo" },
    {
      "key": "lead_status",
      "label": "Lead status",
      "type": "DROPDOWN",
      "options": [
        { "key": "hot", "label": "Hot" },
        { "key": "cold", "label": "Cold" }
      ],
      "source": "allo"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total_count": 2,
    "total_pages": 1,
    "has_more": false
  }
}
```

## Errors

| Status | Code | When |
|--------|------|------|
| `400` | `INVALID_PAGE_SIZE` | `page` is below 1 or `size` is not between 1 and 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 |
