Listar lançamentos da conta virtual

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

string (uuid)

required

Identificador unificado da conta do vendedor.

string (uuid)

required

Identificador da conta virtual.

Parâmetros de query

string

Busca case-insensitive sobre o campo name do lançamento.

integer

Resposta

string (uuid)

Identificador do lançamento.

string

IN (crédito / entrada) ou OUT (débito / saída).

string | null

Rótulo legível, por exemplo "Pagamento de boleto" ou "PIX para Ada Lovelace".

integer

Valor em centavos de BRL. Sempre positivo — o sinal é determinado por kind.

string

Um entre PLANNED, SCHEDULED, PAID, WAITING_CONFIRMATION, REVERSED, FAILED, UNKNOWN. A listagem omite CANCELED e PREDICTED.

string | null

Texto livre com a razão do status quando ele é terminal e malsucedido (por exemplo, "Saldo insuficiente").

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

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

Exemplos

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

import requests

response = requests.get(
    "https://api.dlpay.cloud/uniconta/seller/9c2a.../virtualaccounts/9c2a.../entries/",
    headers={"Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJh..."},
    params={"page_size": 50},
)
entries = response.json()["results"]

const url = new URL(
  "https://api.dlpay.cloud/uniconta/seller/9c2a.../virtualaccounts/9c2a.../entries/"
);
url.searchParams.set("search", "boleto");

const response = await fetch(url, {
  headers: { Authorization: "Bearer eyJ0eXAiOiJKV1QiLCJh..." },
});
const data = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Listar lançamentos da conta virtual

Pré-requisitos

Parâmetros de caminho

Parâmetros de query

Resposta

Exportação

Erros

Exemplos

​Pré-requisitos

​Parâmetros de caminho

​Parâmetros de query

​Resposta

​Exportação

​Erros

​Exemplos

Pré-requisitos

Parâmetros de caminho

Parâmetros de query

Resposta

Exportação

Erros

Exemplos