# Rechercher des personnes

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

`POST /v2/api/crm/people/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) |
| `search` | string | Recherche en texte integral sur les champs de la personne |
| `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": {
    "job_title": "engineer",
    "company": "Acme"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}
```

### Champs de filtre disponibles

| Champ | Type de correspondance | Description |
|-------|----------------------|-------------|
| `name` | contient | Prenom |
| `last_name` | contient | Nom de famille |
| `job_title` | contient | Titre du poste |
| `website` | contient | URL du site web |
| `company` | contient | Nom de l'entreprise |
| `phone_number` | exact | Numero de telephone |
| `email` | contient | Adresse e-mail |
| `deal_status` | exact | Statut du deal |

## Attributs personnalisés

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