Referidos: estado

Ver el estado de referidos de un cliente.

GET/api/v1/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/v1/referrals/status \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa" \
  -d "externalUserId=user_123"

Respuesta

{
  "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)