Referidos: estado

Ver el estado de referidos de un cliente.

GET/api/sdk/referrals/status

Obtiene el codigo de referido, estadisticas y lista de referidos del cliente.

Query params

ParametroTipoDescripcion

Se requiere clientId o externalUserId.

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"
      }
    ]
  }
}
CampoTipoDescripcion
referralCodestringCodigo de referido del cliente
totalReferralsnumberTotal de referidos
pendingReferralsnumberReferidos pendientes de completar
completedReferralsnumberReferidos completados
referredBystring | nullID del cliente que lo refirio (si aplica)
referralsarrayLista de referidos (max 50)