Skip to main content
GET
/
account-service
/
v2
/
accounts
Search accounts with cursor-based pagination
curl --request GET \
  --url https://api.pgw-sandbox.finventi.com/account-service/v2/accounts
{
  "meta": {
    "previousPageToken": "10",
    "nextPageToken": "20"
  },
  "accounts": [
    {
      "id": 1,
      "clientAccountId": "acc_001",
      "iban": "LT121000011111111111",
      "accountType": "PRIVATE",
      "accountHolderName": "Jane Doe",
      "status": "OPEN",
      "createdAt": "2025-09-10T13:43:40.758Z",
      "updatedAt": "2025-09-10T13:55:40.758Z",
      "ibanMetadata": {
        "countryCode": "LT",
        "bankCode": "70440",
        "accountCode": "1869"
      },
      "accountHolderNameAliases": [
        "HGRP"
      ],
      "organisationIdentification": {
        "lei": "3423455234Y45D34",
        "bic": "DEUTDEFFXXX",
        "other": {
          "identification": "123-AS-323",
          "schemeNameCode": "BANK",
          "schemeNameProprietary": "LocalRegistry",
          "issuer": "ChamberOfCommerce"
        }
      }
    }
  ]
}

Overview

This endpoint searches your accounts using various filters with cursor-based pagination. You can filter by IBAN, client account ID, account holder name, or account status.

Cursor-Based Pagination

This endpoint uses cursor-based pagination for large datasets. Start with an initial request, then use nextPageToken to fetch the next page and previousPageToken to go back. Use the limit parameter to control results per page (1–100, default 20).

Query Parameters

iban
string | null

IBAN to search for (exact match)

Example:

"LT121000011111111111"

clientAccountId
string | null

Client account ID to search for (exact match)

Example:

"123e4567-e89b-12d3-a456-426614174000"

accountHolderName
string | null

Account holder name to search for (partial match, case insensitive)

Example:

"John Doe"

status
enum<string> | null

Account status to filter by

Available options:
OPEN,
CLOSED
Example:

"OPEN"

previousPageToken
string | null

Token representing current page position (internal account ID). Use previousPageToken or nextPageToken from response for navigation.

Example:

"123"

nextPageToken
string | null

Token representing current page position (internal account ID). Use previousPageToken or nextPageToken from response for navigation.

Example:

"123"

limit
integer<int32> | null
default:20

Number of results per page (1-100)

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

20

Response

Accounts found

Cursor-based paginated response containing accounts

meta
object
required

Pagination metadata

accounts
object[]
required

List of accounts