Extrato (transações) da subconta
GET
/api/subaccounts/{{subaccount_id}}/transactions
Operação delegada (white-label)
{{subaccount_id}}. Autenticada pela API Key do master.subaccounts:readQuery params
| Param | Tipo | Default | Descrição |
|---|---|---|---|
page | int | 1 | Página (≥1). |
limit | int | 50 | Itens por página (1–100). |
Resposta 200 OK
{ data: [...], pagination: { page, limit, total, pages } }. Cada lançamento:| Campo | Tipo | Notas |
|---|---|---|
id | string | |
type | string | CREDIT / DEBIT. |
amount | int | CENTAVOS (negativo em débitos). |
description | string | |
referenceType | string|null | Ex: WITHDRAWAL, WITHDRAWAL_REFUND. |
referenceId | string|null | ID da entidade de origem. |
balanceAfter | int | CENTAVOS — saldo após o lançamento. |
createdAt | string | ISO8601. |
Sigilo (crítico): o extrato da subconta NUNCA contém lançamentos do tipo COMMISSION— a comissão é lançada apenas no extrato do master. Nenhuma decomposição de taxa aparece aqui.
Códigos de erro
| HTTP | Quando |
|---|---|
401 | API Key ausente/inválida. |
404 | Master sem white-label, ou subconta inexistente/não-sua. |
Exemplo cURL
Requisição
Parâmetros de Consulta
Parâmetros Header
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '/api/subaccounts/{{subaccount_id}}/transactions?page=1&limit=50' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"id": "cltx0002",
"type": "DEBIT",
"amount": -10000,
"description": "Saque solicitado - R$ 95,00 (taxa: R$ 5,00)",
"referenceType": "WITHDRAWAL",
"referenceId": "clwd0001",
"balanceAfter": 152340,
"createdAt": "2026-05-07T14:40:00.000Z"
},
{
"id": "cltx0001",
"type": "CREDIT",
"amount": 2901,
"description": "Cobrança paga - Pedido #1234",
"referenceType": "CHARGE",
"referenceId": "clsubcharge0001",
"balanceAfter": 162340,
"createdAt": "2026-05-07T14:35:12.000Z"
}
],
"pagination": { "page": 1, "limit": 50, "total": 2, "pages": 1 }
}Modificado em 2026-07-02 06:57:27