GET /customers

Lister les clients

Récupérez vos clients avec leurs scores de churn actuels. Pagination par curseur, filtres par label et score.

GEThttps://zedcheckout.com/api/v1/customersEssentiel

Récupérez vos clients avec leurs scores de churn actuels. Pagination par curseur, filtres par label et score.

Auth — X-API-Key

Catégorie — Customers

Query parameters

Nom	Type	Requis	Description
churn_label	string[]	—	low, medium, high, critical
min_score	float	—	Score minimum (0–1)
max_score	float	—	Score maximum (0–1)
sort	string	—	churn_score_desc \| last_activity_desc \| …
limit	integer	—	Résultats par page (1–200, défaut 50)
cursor	string	—	Curseur de pagination (positif)

Exemples

curl -X GET 'https://zedcheckout.com/api/v1/customers' \
  -H 'X-API-Key: api_zedcheckout_votre_cle_api'

Réponses

200OK

{
  "data": [{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "external_id": "cust_789",
    "churn": {
      "score": "0.72",
      "label": "high",
      "calculated_at": "2026-05-15T08:00:00Z",
      "model_version": "rules_v1"
    }
  }],
  "pagination": { "next_cursor": "eyJpZCI6...", "has_more": true }
}

Erreurs

401unauthorizedClé API invalide
422validation_errorcursor négatif ou limit hors bornes

Voir tous les codes d'erreur →