Referidos: estado
Ver el estado de referidos de un cliente.
GET
/api/sdk/referrals/statusObtiene el codigo de referido, estadisticas y lista de referidos del cliente.
Query params
| Parametro | Tipo | Descripcion |
|---|
Se requiere
clientIdoexternalUserId.
Ejemplo
curl -G https://southgames.ai/api/sdk/referrals/status \
-H "Authorization: Bearer sg_live_xxx" \
-H "X-Org-Id: mi-empresa" \
-d "externalUserId=user_123"
Respuesta
{
"success": true,
"data": {
"referralCode": "REF-A1B2C3",
"totalReferrals": 5,
"pendingReferrals": 2,
"completedReferrals": 3,
"referredBy": null,
"referrals": [
{
"id": "ref_001",
"referredClientId": "client_xyz",
"status": "completed",
"createdAt": "2026-03-10T15:30:00.000Z",
"completedAt": "2026-03-11T10:00:00.000Z"
}
]
}
}
| Campo | Tipo | Descripcion |
|---|---|---|
referralCode | string | Codigo de referido del cliente |
totalReferrals | number | Total de referidos |
pendingReferrals | number | Referidos pendientes de completar |
completedReferrals | number | Referidos completados |
referredBy | string | null | ID del cliente que lo refirio (si aplica) |
referrals | array | Lista de referidos (max 50) |