# Rechercher des entreprises

> Cet endpoint est pagine. Utilisez page et size dans le corps de la requete pour controler les resultats. Voir Pagination.

`POST /v2/api/crm/companies/search`

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

Cet endpoint est pagine. Utilisez `page` et `size` dans le corps de la requete pour controler les resultats. Voir [Pagination](/fr/docs/guides/pagination).

## Corps de la requete

| Champ | Type | Description |
|-------|------|-------------|
| `filters` | object | Filtres nommes (voir ci-dessous) |
| `sort` | string | Ordre de tri : `DATE_DESC`, `DATE_ASC`, `NAME_ASC`, `NAME_DESC`, `CREATED_DESC`, `CREATED_ASC` |
| `page` | integer | Numero de page (commence a 1) |
| `size` | integer | Resultats par page (max 100) |

## Filtres

Passez un objet avec des champs nommes. Tous les filtres fournis sont combines avec AND.

```json
{
  "filters": {
    "name": "Acme",
    "industry": "Technology"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}
```

### Champs de filtre disponibles

| Champ | Type de correspondance | Description |
|-------|----------------------|-------------|
| `name` | contient | Nom de l'entreprise |
| `website` | contient | URL du site web |
| `industry` | contient | Secteur d'activite |

## Attributs personnalisés

Chaque résultat inclut `custom_attributes`, les valeurs de vos [attributs d'entreprise](/fr/docs/crm/create-company-attribute) indexées par clé d'attribut. Toujours présent, `{}` s'il n'y en a aucune, avec les mêmes formats que [Obtenir une entreprise](/fr/docs/crm/get-company). Les attributs personnalisés ne peuvent servir ni de filtre ni de tri.
