Passer au contenu principal

Endpoint

GET /api/v1/contacts/groups

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 description (1-100 caractères)

Réponse succès 200

{
  "data": {
    "groups": [
      {
        "id": "grp_uuid",
        "name": "VIPs",
        "description": "Contacts prioritaires",
        "color": "#facc15",
        "contactCount": 42,
        "createdAt": "2026-04-01T10:00:00.000Z"
      }
    ],
    "total": 7,
    "limit": 50,
    "nextCursor": null,
    "hasMore": false
  }
}

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.