Listar cobranças

Escopo: invoices:read — Cobranças do estabelecimento: valores, líquido, split, forma de pagamento e nome/e-mail do pagador.

Cobranças do estabelecimento, paginadas por cursor. Todos os parâmetros vão na query string e são opcionais.

parâmetro
bizIduid do estabelecimento. Dispensável com chave exclusiva de um estabelecimento; obrigatório nas demais
statusseparados por vírgula: WAITING (em aberto), PAID, EXPIRED, CANCELLED, REFUNDED. Sem ele, todos
paymentMethodseparados por vírgula: PIX, CREDIT, BANK_SLIP, LOCAL, TED, BALANCE, FREE_PASS, LOYALTY, LEP_GIFT. Sem ele, todas — inclusive cobrança ainda sem forma de pagamento
dateFielddueDate (padrão) ou paymentDate — campo do intervalo e da ordenação. Com paymentDate, só vêm cobranças pagas
from, toISO 8601; sem offset é horário do negócio. from inclusivo, to exclusivo
limit1 a 200, padrão 50
cursorpagination.nextCursor da página anterior

status × paymentMethod pode ter no máximo 30 combinações (ex.: os 5 status com as 9 formas não passa); acima disso, 400.

Paginação

  • Ordem: dateField crescente, desempate pelo id. Paginando até hasMore: false vêm todas, sem repetir nem pular.
  • Lançamentos da plataforma (saques, taxas, repasses, pacote de créditos, demonstração) não são cobrança e ficam de fora. Por isso uma página pode vir com menos de limit itens, até vazia, e ainda ter hasMore: true — continue pelo cursor.
  • O cursor só vale com os mesmos filtros; trocar algum responde 400. O limit pode mudar entre páginas.

Campos — os mesmos de invoices em Detalhar assinatura, mais:

  • itemPaidId: o que a cobrança paga — o id da assinatura em mensalidades (abra em Detalhar assinatura).
  • payer: nome e e-mail de quem paga.

id é o id da cobrança no Asaas (pay_…); valueCents, o valor cheio; netAfterSplitCents, o que fica para o estabelecimento depois de taxas e split; paymentDate e receiptUrl (comprovante) só vêm quando pago; em paymentMethod: LOCAL (registrado à mão), localPaymentMethod diz como.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

uid do estabelecimento. Dispensável com chave exclusiva de um estabelecimento; obrigatório nas demais.

string

Separados por vírgula: WAITING, PAID, EXPIRED, CANCELLED, REFUNDED. Sem ele, todos.

string

Separados por vírgula: PIX, CREDIT, BANK_SLIP, LOCAL, TED, BALANCE, FREE_PASS, LOYALTY, LEP_GIFT. Sem ele, todas. status × paymentMethod: no máximo 30 combinações.

string
enum
Defaults to dueDate

Campo do intervalo e da ordenação. Com paymentDate, só pagas.

Allowed:
string

ISO 8601, inclusivo. Sem offset é horário do negócio.

string

ISO 8601, exclusivo.

integer
1 to 200
Defaults to 50

Itens por página.

string

pagination.nextCursor da página anterior. Só vale com os mesmos filtros; trocar algum responde 400.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json