Consultar un suscriptor

GET /v1/subscribers/:id

Requiere el permiso subscribers:read o full. Los permisos se comprueban en el servidor. Las claves test se rechazan con 403 test_mode_unavailable; no existe un sandbox aislado.

Devuelve el suscriptor con el ID indicado.

Parámetro de ruta

id es el identificador sub_… del suscriptor. También se admite el UUID sin prefijo, con o sin guiones. Cualquier otro formato devuelve 400 invalid_param.

Para buscar por email o ID propio utiliza listar con filter[email] o filter[external_id] y limit=1.

Respuesta

El objeto del suscriptor con 200 OK, o 404 resource_not_found si no existe en la marca.

Ejemplo

curl https://fluyio.com/api/v1/subscribers/sub_9f1c2b3a4d5e6f708192a3b4c5d6e7f8 \
  -H "Authorization: Bearer $FLUYIO_API_KEY" \
  -H "Fluyio-Version: 2026-05-15"

# Look up by your own id instead
curl -g "https://fluyio.com/api/v1/subscribers?filter[external_id]=user_12345&limit=1" \
  -H "Authorization: Bearer $FLUYIO_API_KEY" \
  -H "Fluyio-Version: 2026-05-15"

Respuesta

{
  "id": "sub_9f1c2b3a4d5e6f708192a3b4c5d6e7f8",
  "object": "subscriber",
  "email": "[email protected]",
  "phone": "+34600000000",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "external_id": "user_12345",
  "consent": {
    "email": "subscribed",
    "sms": "subscribed",
    "whatsapp": "never_subscribed"
  },
  "properties": {
    "company": "Analytical Engines",
    "plan": "pro",
    "country": "ES"
  },
  "lists": ["lst_0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f"],
  "tags": ["beta", "vip"],
  "created_at": "2026-05-11T12:34:56.000Z",
  "updated_at": "2026-05-11T12:34:56.000Z",
  "last_active_at": "2026-05-11T15:00:00.000Z"
}

Errores

| 400 | invalid_param | El ID no es válido (param: id). | | 404 | resource_not_found | El suscriptor no existe en la marca. |