Endpoint: GET /subscriptions/subscriber/{subscriber_id}/
Autenticação: Público (sem autenticação)
Retorna um assinante pelo UUID, o plano ao qual ele está vinculado e a lista de seus pagamentos pending e failed. O UUID é não-adivinhável, então este endpoint é seguro para ser exposto em uma página de autoatendimento do assinante (ex.: link “gerenciar minha assinatura” enviado por e-mail).

​
Pré-requisitos

  • O assinante já deve existir — criado por POST /subscriptions/plan/{plan_id}/subscribe/ ou pelo vendedor via API autenticada.

​
Parâmetros de rota

​
subscriber_id
string
required
UUID do assinante.

​
Resposta

​
id
string
UUID do assinante.
​
name
string
Nome completo do assinante.
​
email
string
E-mail do assinante.
​
phone_number
string
Número de telefone (somente dígitos).
​
country_code
string
Prefixo de país E.164, ex.: +55.
​
taxpayer_id
string
CPF ou CNPJ.
​
status
string
Status do ciclo de vida do assinante. Um dos valores pending (aguardando primeiro pagamento), paid (em dia), failed (última cobrança falhou), overdue (vencido) ou canceled (cancelado).
​
next_billing_date
string
Timestamp ISO-8601 da próxima cobrança programada.
​
subscribed_at
string
Timestamp ISO-8601 em que o assinante foi criado.
​
saved_card
object
Resumo do cartão tokenizado em arquivo, ou null. Campos: card_brand, last4_digits, holder_name.
​
plan
object
Resumo embutido do plano:
  • id — UUID do plano.
  • name — nome do plano.
  • amount — centavos de BRL como string.
  • frequency — weekly … annual.
​
pending_payments
array
Todos os pagamentos pending e failed deste assinante, do mais recente para o mais antigo. Cada entrada usa o formato público de pagamento — veja Listar pagamentos do assinante (público).
{
  "id": "f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d",
  "name": "Maria Souza",
  "email": "maria@example.com",
  "phone_number": "11988887777",
  "country_code": "+55",
  "taxpayer_id": "12345678901",
  "status": "paid",
  "next_billing_date": "2026-06-14T12:30:00-03:00",
  "subscribed_at": "2026-05-14T12:30:00-03:00",
  "saved_card": {
    "card_brand": "visa",
    "last4_digits": "4242",
    "holder_name": "MARIA SOUZA"
  },
  "plan": {
    "id": "8b0e9f4a-2b7d-4f3f-9d8a-1c2e3a4b5c6d",
    "name": "Clube do Café — Mensal",
    "amount": "4990",
    "frequency": "monthly"
  },
  "pending_payments": []
}

​
Erros

StatusQuando
404Não existe assinante com o subscriber_id informado.

​
Exemplos

curl https://api.dlpay.cloud/subscriptions/subscriber/f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d/