# Lister les attributs d'entreprise

> Renvoie les attributs personnalisés définis sur les entreprises de votre équipe, qu'ils aient été créés par vous ou synchronisés depuis vos intégrations CRM…

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

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

Renvoie les attributs personnalisés définis sur les entreprises de votre équipe, qu'ils aient été créés par vous ou synchronisés depuis vos intégrations CRM. Les attributs archivés ne sont pas listés.

## 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 |

## Champs de la réponse

| Champ | Type | Description |
|-------|------|-------------|
| `key` | string | Clé unique de l'attribut |
| `label` | string ou null | Nom affiché |
| `type` | string ou null | `TEXT`, `NUMBER`, `DATE`, `BOOLEAN` ou `DROPDOWN` |
| `options` | array ou null | Objets `{ key, label }`. Uniquement pour `DROPDOWN` |
| `is_visible` | boolean | Indique si l'attribut est affiché dans les apps Allo |
| `prompt` | string ou null | Consigne utilisée par l'AI CRM Manager pour remplir l'attribut à partir des appels |
| `should_prompt_override` | boolean ou null | Indique si l'IA peut écraser une valeur existante |
| `source` | string | `allo`, ou l'intégration qui gère l'attribut, comme `hubspot` |
| `created_at` | string | Date-heure ISO 8601 |
| `updated_at` | string | Date-heure ISO 8601 |

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

## 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` | Le workspace n'utilise pas le nouveau modèle de contacts |
