# Lister les champs personnalisés

> Renvoie les champs personnalisés définis sur les personnes de votre équipe, du plus ancien au plus récent. La liste inclut les champs créés via l'API et ceux…

`GET /v2/api/crm/attributes`

<Note>
**Scope requis :** `CRM_READ`
</Note>

Renvoie les champs personnalisés définis sur les personnes de votre équipe, du plus ancien au plus récent. La liste inclut les champs créés via l'API et ceux synchronisés depuis vos intégrations CRM. Les champs supprimés (archivés) et les champs natifs comme `name` ou `company` n'y figurent pas.

## Paramètres de requête

| Paramètre | Type | Défaut | Description |
|-----------|------|--------|-------------|
| `page` | integer | `1` | Numéro de page, à partir de 1 |
| `size` | integer | `20` | Éléments par page, de 1 à 100 |

Voir [Pagination](/fr/docs/guides/pagination).

## Champs de la réponse

| Champ | Type | Description |
|-------|------|-------------|
| `key` | string | Clé unique du champ |
| `label` | string ou null | Nom affiché |
| `type` | string ou null | `TEXT`, `NUMBER`, `DATE`, `BOOLEAN` ou `DROPDOWN` |
| `options` | array | Objets `{ key, label }`. Uniquement présent pour `DROPDOWN` |
| `source` | string | `allo`, ou l'intégration qui gère le champ, comme `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
  }
}
```

## Erreurs

| Statut | Code | Quand |
|--------|------|-------|
| `400` | `INVALID_PAGE_SIZE` | `page` est inférieur à 1 ou `size` n'est pas compris entre 1 et 100 |
| `403` | `API_KEY_INSUFFICIENT_SCOPE` | La clé n'a pas le scope `CRM_READ` |
| `404` | `TEAM_NOT_FOUND` | L'espace de travail n'utilise pas le nouveau modèle de contacts |
