Passer au contenu principal

​
Endpoint

GET /api/v1/contacts

​
Paramètres query

ChampTypeRequisDescription
limitintegernonTaille de page, défaut 50, max 100
cursorstringnonCurseur opaque retourné par la page précédente
searchstringnonRecherche insensible à la casse sur name ou phone (1-100 caractères)
sortstringnoncreatedAt_desc (défaut) ou name_asc

​
Réponse succès 200

{
  "data": {
    "contacts": [
      {
        "id": "cnt_uuid",
        "name": "Awa Doe",
        "phone": "+33612345000",
        "tags": ["vip"],
        "temperature": null,
        "createdAt": "2026-04-01T10:00:00.000Z",
        "updatedAt": "2026-04-01T10:00:00.000Z"
      }
    ],
    "total": 240,
    "limit": 50,
    "sort": "createdAt_desc",
    "nextCursor": "MjAyNi0wNC0wMVQxMDowMDowMC4wMDBafGNudF91dWlk",
    "hasMore": true
  }
}

​
Notes

  • Repassez la valeur de nextCursor comme cursor pour récupérer la page suivante. Arrêtez quand hasMore est false ou nextCursor vaut null.
  • Le curseur encode le tuple de tri (createdAt|id ou name|id). Ne mélangez pas les tris entre les pages.