Listar o plano de contas
RegistosGET /ledger/accounts
Returns the general ledger accounts of the caller's tenant, ordered by account number, with cursor pagination (limit defaults to 20, at most 100). The optional q parameter matches account names and numbers. Requires the ledger:read permission.
Parâmetros
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
qFilter by name or number
activeFilters by account state: the value
truereturns only active accounts, any other non-empty value returns only inactive accounts, and omitting it returns both.
Devolve
200 Accounts
Mostrar atributos
dataMostrar atributos filhos
tenant_ididaccount_numberaccount_nameaccount_typeum de
asset,liability,equity,revenue,expenserolecurrencyis_reconciledactivecreated_at
has_morenext_cursor
Erros 403
Permissões ledger:read · Funções: admin, analyst, billing_clerk, customer_service, finance, owner, viewer
curl -X GET "$BUSINESS_API/ledger/accounts" \
-H "Authorization: Bearer sk_test_..."
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$BUSINESS_API/ledger/accounts", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/ledger/accounts",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/ledger/accounts", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"id": "led_2DDAMfBcGzd6gv98kDhKqFBU6lt",
"account_number": "ACC-2026-000142",
"account_name": "Ana Matsinhe",
"account_type": "asset",
"role": "role",
"currency": "MZN",
"is_reconciled": true,
"active": true,
"created_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}