Endpoint: GET /subscriptions/seller/{seller_id}/plans/{plans_pk}/subscribers/
Autenticação: JWT bearer ou chave de API
Lista todos os assinantes cujo plano é o identificado por plans_pk, ordenados por subscribed_at decrescente. A listagem usa uma projeção mais enxuta sem as métricas de pagamento.

​
Pré-requisitos

  • Quem chama precisa estar autenticado contra o vendedor identificado por seller_id.
  • O plano referenciado por plans_pk precisa pertencer a esse vendedor.

​
Parâmetros de rota

​
seller_id
string
required
UUID unificado da conta do vendedor.
​
plans_pk
string
required
UUID do plano de assinatura pai.

​
Parâmetros de query

​
search
string
Busca de subsequência sem distinção de maiúsculas/minúsculas em name, email e taxpayer_id.

​
Resposta

Retorna um array de linhas resumidas de assinante, do mais recente para o mais antigo.
​
id
string
UUID do assinante.
​
name
string
Nome completo.
​
email
string
E-mail do assinante.
​
taxpayer_id
string
CPF ou CNPJ.
​
status
string
Um dos valores pending, paid, failed, overdue, canceled.
​
next_billing_date
string
Timestamp ISO-8601 da próxima cobrança programada.
​
last_payment_date
string
Timestamp ISO-8601 do último pagamento confirmado, ou null.
​
subscribed_at
string
Timestamp ISO-8601 em que o assinante foi criado.
​
canceled_at
string
Timestamp ISO-8601 em que o assinante foi cancelado, ou null.
[
  {
    "id": "f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d",
    "name": "Maria Souza",
    "email": "maria@example.com",
    "taxpayer_id": "12345678901",
    "status": "paid",
    "next_billing_date": "2026-06-14T12:30:00-03:00",
    "last_payment_date": "2026-05-14T12:30:04-03:00",
    "subscribed_at": "2026-05-14T12:30:00-03:00",
    "canceled_at": null
  }
]

​
Erros

StatusQuando
401Token ausente ou inválido.
403Chamador sem vínculo com este vendedor.
404O plano não existe ou não pertence a este vendedor.

​
Exemplos

curl https://api.dlpay.cloud/subscriptions/seller/SELLER_ID/plans/PLAN_ID/subscribers/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"