Listar contas virtuais de uma conta gerenciada (admin)

Endpoint: GET /uniconta/admin/managed-accounts/{managed_accounts_pk}/virtual-accounts/

Acesso restrito (apenas superusuário). Qualquer usuário não-superusuário recebe 403.

Retorna todas as contas virtuais cujo managed_account_id corresponde ao informado, ordenadas por created_at decrescente. Cada linha é enriquecida com a identidade da conta unificada (pessoa / empresa / display name / e-mail) e o balance em tempo real.

Pré-requisitos

A conta gerenciada existe.
O usuário é superusuário.

Parâmetros de caminho

integer

required

Identificador da conta gerenciada.

Parâmetros de query

string

Busca case-insensitive sobre a conta vinculada: account.person.first_name, account.person.last_name, account.company.name, account.email, account.display_name.

integer

Resposta

string (uuid)

Identificador da conta virtual.

object

Conta unificada vinculada: id, display_name, identidade de pessoa/empresa.

integer

Saldo atual em centavos de BRL (PAID IN − PAID OUT − WAITING_CONFIRMATION OUT). Retorna 0 quando o cálculo falha (por exemplo, conta órfã).

string (datetime)

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10",
      "account": {
        "id": "9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10",
        "display_name": "Ada Lovelace",
        "email": "ada@example.com"
      },
      "balance": 158400,
      "created_at": "2026-04-12T14:01:33-03:00",
      "updated_at": "2026-05-11T08:42:10-03:00"
    }
  ]
}

Erros

Status	Quando
`401`	Token ausente ou inválido.
`403`	O usuário não é superusuário.

Exemplos

curl "https://api.dlpay.cloud/uniconta/admin/managed-accounts/1/virtual-accounts/?search=lovelace" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh..."

import requests

response = requests.get(
    "https://api.dlpay.cloud/uniconta/admin/managed-accounts/1/virtual-accounts/",
    headers={"Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJh..."},
    params={"page_size": 100},
)
data = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/uniconta/admin/managed-accounts/1/virtual-accounts/",
  { 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 contas virtuais de uma conta gerenciada (admin)

Pré-requisitos

Parâmetros de caminho

Parâmetros de query

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de caminho

​Parâmetros de query

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de caminho

Parâmetros de query

Resposta

Erros

Exemplos