Skip to main content
GET
/
v1
/
accounts
Get a list of accounts
curl --request GET \
  --url https://api.example.com/v1/accounts
{
  "data": [
    {
      "accountId": "019bdb2a-960f-789d-8955-21720e6cdeed",
      "iban": "LT647044001231465456",
      "partyId": "019bdb2a-960f-789d-8955-21720e6cdeee",
      "status": "OPENED",
      "createdAt": "2026-01-22T13:47:21.542163Z",
      "statusUpdatedAt": "2026-01-22T13:47:21.542163Z",
      "balances": [
        {
          "availableBalance": 100000,
          "currency": "EUR"
        }
      ],
      "currentLedgerAccount": "CUSTOMER:party-uuid:account-uuid:CURRENT",
      "holdingLedgerAccount": "CUSTOMER:party-uuid:account-uuid:HOLDING"
    }
  ],
  "page": 0,
  "size": 100,
  "totalPages": 5
}

Documentation Index

Fetch the complete documentation index at: https://docs.finventi.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
currentLedgerAccounts
object

Filter by current ledger account identifiers

Example:
[
  "CUSTOMER:034995c6-7f46-4298-9569-cdf1bb572102:9c576ecc-3000-4ad2-9be9-876bb9b93de9:CURRENT"
]
​
iban
string | null

Filter by IBAN

Example:

"LT643500012345678901"

​
page
integer<int32>

Page number (0-based)

Required range: x >= 0
Example:

0

​
partyId
string<uuid> | null

Filter by party ID

Pattern: [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}
Example:

"019bdb2a-960f-789d-8955-21720e6cdeee"

​
size
integer<int32>

Number of items per page (max 100)

Required range: 1 <= x <= 100
Example:

20

​
sortBy
string

Field name to sort by

Example:

"createdAt"

​
sortDirection
object

Sort direction

Response

Paginated list of accounts

Paginated response wrapper

​
data
object[]

List of items for the current page

​
page
integer<int32>

Current page number (0-based)

Example:

0

​
size
integer<int32>

Number of items per page

Example:

100

​
totalPages
integer<int32>

Total number of pages

Example:

5

Last modified on February 10, 2026