GET
/api/v1/clientsLister les clients
Les clients de l'organisation, les plus récents d'abord, avec recherche par nom.
Liste les clients de l'organisation, du plus récent au plus ancien. Le
paramètre search sert surtout à vérifier qu'un client existe avant d'en
créer un.
Paramètres de requête
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
search | string | Recherche partielle sur le nom, insensible à la casse (200 caractères max) | |
limit | number | 50 | 1 à 100 |
cursor | string | L'id du dernier élément reçu — voir Pagination |
Exemple
curl "https://www.tetikasa.app/api/v1/clients?search=acme" \
-H "Authorization: Bearer $TETIKASA_API_KEY"Réponse
next_cursor vaut null quand il n'y a plus rien à lire ; sinon, repassez-le
tel quel dans cursor pour la page suivante.
Erreurs
code | Statut | Quand |
|---|---|---|
invalid_request | 422 | limit hors de 1–100, ou search trop long |
unauthorized | 401 | Clé absente, invalide, révoquée ou expirée |