Obter contexto público do assinante

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

string

required

UUID do assinante.

Resposta

string

UUID do assinante.

string

Nome completo do assinante.

string

E-mail do assinante.

string

Número de telefone (somente dígitos).

string

Prefixo de país E.164, ex.: +55.

string

CPF ou CNPJ.

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).

string

Timestamp ISO-8601 da próxima cobrança programada.

string

Timestamp ISO-8601 em que o assinante foi criado.

object

Resumo do cartão tokenizado em arquivo, ou null. Campos: card_brand, last4_digits, holder_name.

object

Resumo embutido do plano:

id — UUID do plano.
name — nome do plano.
amount — centavos de BRL como string.
frequency — weekly … annual.

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

Status	Quando
`404`	Não existe assinante com o `subscriber_id` informado.

Exemplos

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

import requests

response = requests.get(
    "https://api.dlpay.cloud/subscriptions/subscriber/f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d/",
)
subscriber = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/subscriptions/subscriber/f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d/",
);
const subscriber = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Obter contexto público do assinante

Pré-requisitos

Parâmetros de rota

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de rota

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de rota

Resposta

Erros

Exemplos