Skip to main content
GET
/
v1
/
subscriptions
Lister les abonnements
curl --request GET \
  --url https://api.example.com/v1/subscriptions

​
Lister les abonnements

Récupère la liste de tous vos abonnements avec filtres optionnels.

​
Endpoint

GET /v1/subscriptions

​
Headers

HeaderRequisDescription
Authorization✅Bearer sk_xxx

​
Query Parameters

ParamètreTypeRequisDescription
plan_idstringFiltrer par plan
statusstringFiltrer par statut (ACTIVE, PAST_DUE, CANCELLED)
limitintegerNombre de résultats (défaut: 20)

​
Exemple

curl "https://api.sahelpay.ml/v1/subscriptions?status=ACTIVE&limit=20" \
  -H "Authorization: Bearer sk_test_xxx"

​
Réponse

{
  "success": true,
  "data": {
    "subscriptions": [
      {
        "id": "sub_abc123",
        "plan_id": "plan_abc123",
        "plan_name": "Premium Mensuel",
        "customer_phone": "+22370123456",
        "status": "ACTIVE",
        "next_billing_date": "2025-01-01T00:00:00.000Z",
        "retry_count": 0,
        "created_at": "2025-12-18T16:45:00.000Z"
      }
    ],
    "pagination": {
      "total": 50,
      "limit": 20
    }
  }
}