Endpoint: GET /uniconta/seller/{account_id}/virtualaccounts/{virtualaccounts_pk}/entries/
Autenticação: obrigatória — JWT via Authorization: Bearer <access_token>. O usuário precisa ter acesso à account_id ou ser superusuário.
Um lançamento de conta virtual é uma linha do razão financeiro da conta. Cada lançamento é uma entrada (kind=IN, crédito) ou uma saída (kind=OUT, débito), possui um valor em centavos de BRL, um status, e referencia a origem que o gerou: um recebível, um pagamento de boleto ou uma transferência. Este endpoint retorna os lançamentos pertencentes à conta virtual informada, ordenados por created_at decrescente. Lançamentos com status CANCELED ou PREDICTED são omitidos da listagem — são ruídos contábeis sem efeito no saldo apresentado. A resposta é paginada.

​
Pré-requisitos

  • A conta virtual existe e pertence à account_id. Utilize o endpoint de listagem/detalhe de contas virtuais antes.

​
Parâmetros de caminho

​
account_id
string (uuid)
required
Identificador unificado da conta do vendedor.
​
virtualaccounts_pk
string (uuid)
required
Identificador da conta virtual.

​
Parâmetros de query

​
search
string
Busca case-insensitive sobre o campo name do lançamento.
​
page
integer
​
page_size
integer

​
Resposta

​
id
string (uuid)
Identificador do lançamento.
​
kind
string
IN (crédito / entrada) ou OUT (débito / saída).
​
name
string | null
Rótulo legível, por exemplo "Pagamento de boleto" ou "PIX para Ada Lovelace".
​
amount
integer
Valor em centavos de BRL. Sempre positivo — o sinal é determinado por kind.
​
status
string
Um entre PLANNED, SCHEDULED, PAID, WAITING_CONFIRMATION, REVERSED, FAILED, UNKNOWN. A listagem omite CANCELED e PREDICTED.
​
status_reason
string | null
Texto livre com a razão do status quando ele é terminal e malsucedido (por exemplo, "Saldo insuficiente").
​
created_at
string (datetime)
​
updated_at
string (datetime)
{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "4b1f0c66-9e8a-4d2b-baaa-2c1a4d3e5f10",
      "kind": "OUT",
      "name": "PIX para Ada Lovelace",
      "amount": 15000,
      "status": "WAITING_CONFIRMATION",
      "status_reason": null,
      "created_at": "2026-05-11T09:00:01-03:00",
      "updated_at": "2026-05-11T09:00:04-03:00"
    },
    {
      "id": "21bb0c41-7d8a-4f10-b002-9b441adf12aa",
      "kind": "IN",
      "name": "Recebivel 9001",
      "amount": 50000,
      "status": "PAID",
      "status_reason": null,
      "created_at": "2026-05-09T14:32:00-03:00",
      "updated_at": "2026-05-09T14:32:00-03:00"
    }
  ]
}

​
Exportação

Há também a ação de exportação: 
GET /uniconta/seller/{account_id}/virtualaccounts/{virtualaccounts_pk}/entries/report/
Retorna até 1000 linhas com id, nome, valor (assinado, decimal com vírgula como separador, dividido por 100), status, motivo status, criado_em, atualizado_em. Escolha o formato pelo cabeçalho Accept (text/csv, application/vnd.ms-excel, text/plain).

​
Erros

StatusQuando
401Token ausente ou inválido.
403O usuário não tem acesso à account_id.
404A conta virtual não existe.

​
Exemplos

curl "https://api.dlpay.cloud/uniconta/seller/9c2a.../virtualaccounts/9c2a.../entries/?search=PIX" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh..."