v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB
Accounts API

List Accounts

Use this endpoint to list all accounts in your Ledger.

get/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts

Path parameters

organization_idstring uuid required

The unique identifier of the Organization associated with the Ledger.

ledger_idstring uuid required

The unique identifier of the associated Ledger.

Query parameters

limitinteger

The maximum number of items to include in the response. Max: 100

start_datestring

The beginning of the period you want to retrieve. start_date and end_date are all-or-nothing: supplying only one returns 400. If both are omitted, a default window of the last 1 month is used.

end_datestring

The end of the period you want to retrieve. start_date and end_date are all-or-nothing: supplying only one returns 400. If both are omitted, a default window of the last 1 month is used.

sort_order'asc' | 'desc'

The order used to sort the results.

pageinteger

The number of the page that you want to retrieve.

portfolio_idstring uuid

Filter accounts by portfolio. Returns only accounts assigned to this portfolio.

segment_idstring uuid

Filter accounts by segment. Returns only accounts assigned to this segment.

status'ACTIVE' | 'INACTIVE' | 'BLOCKED'

Filter accounts by their status code. Accepted values are ACTIVE, INACTIVE, or BLOCKED (uppercase, exact match).

typestring

Filter accounts by type (exact match, case-insensitive). Common values include deposit, savings, loans, marketplace, creditCard, and external.

asset_codestring

Filter accounts by asset code (e.g. BRL, USD).

entity_idstring

Filter accounts by entity identifier.

blockedboolean

Filter accounts by blocked state. Use true to list only blocked accounts, false for unblocked.

parent_account_idstring uuid

Filter accounts by parent account. Returns only sub-accounts of the specified parent.

namestring

Filter accounts by name. Uses prefix matching (case-insensitive).

aliasstring

Filter accounts by alias. Uses prefix matching (case-insensitive).

metadata.keystring

Filter by metadata using dot-notation. Replace key with your metadata field name (e.g. metadata.costCenter=BR_11101997).

Headers

Content-Typestring

The type of media of the resource. Recommended value is application/json.

X-Request-Idstring uuid

A unique identifier used to trace and track each request.

Authorizationstring

Bearer JWT token for authentication. Required when PLUGIN_AUTH_ENABLED=true (enforced in multi-tenant deployments). Optional in default OSS single-tenant mode. Format: Bearer <token>

Response

Indicates that the request was successful and the response contains the expected data.

pageinteger

The number of pages returned.

limitinteger

The maximum number of items included in the response.