GET/v1/subscribers/{id}

Obter assinante

Devolve o assinante com tags e atributos. Útil para atender um pedido de acesso aos dados (LGPD).

Send request

Use the documented inputs to call this endpoint directly.

API serverbase URL

Bearer tokenchaveSecretaoptional

Stored only in this browser for the chaveSecreta security scheme and reused on every API page in this group.

Parameters

Values are applied to the request and the example on the right.

idpath · string · uuidrequired

UUID do assinante, o campo id de Listar assinantes.

Responses

200application/json

O assinante.

{
  "id": "0199b2d4-6f1e-7c3a-9b1e-2f4a8c6d0e11",
  "external_id": "user-42",
  "tags": [
    "vip",
    "newsletter"
  ],
  "attributes": {
    "plano": "anual",
    "pedidos": 7
  },
  "active_devices": 2,
  "created_at": "2026-09-28T14:03:11+00:00"
}

idstring · uuidoptional

UUID do assinante.

external_idstringoptional

ID do usuário no seu sistema, quando informado no login. Pode ser null.

tagsarray<string>optional

active_devicesintegeroptional

Dispositivos com inscrição ativa.

created_atstring · date-timeoptional

attributesobjectoptional

Atributos do assinante, com o tipo original (texto, número ou booleano).

401application/json

Chave ausente, inválida ou revogada.

{
  "message": "Credencial ausente ou inválida."
}

messagestringoptional

Descrição do erro, em português. Quando a causa não tem mensagem própria, vem a mensagem padrão do código HTTP. Trate pelo código, não pelo texto.

404application/json

Não existe com esse ID neste site.

{
  "message": "Recurso não encontrado."
}

messagestringoptional

Descrição do erro, em português. Quando a causa não tem mensagem própria, vem a mensagem padrão do código HTTP. Trate pelo código, não pelo texto.

429application/json

Limite de requisições excedido. Espere os segundos indicados em Retry-After.

{
  "message": "Muitas requisições. Tente novamente em instantes."
}

messagestringoptional

Descrição do erro, em português. Quando a causa não tem mensagem própria, vem a mensagem padrão do código HTTP. Trate pelo código, não pelo texto.