Skip to main content
GET
/
account-service
/
v2
/
accounts
/
{id}
Get account by ID
curl --request GET \
  --url https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}
{
  "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

Retrieves detailed information for a specific account using its unique ID. The response includes all account metadata, holder information, and current status.

Path Parameters

​
id
integer<int64>
required

ID

Response

Account found

Account information response

​
id
integer<int64>
required

Internal account identifier

Example:

1

​
clientAccountId
string
required

Client's internal account ID

Example:

"acc_001"

​
iban
string
required

International Bank Account Number

Example:

"LT121000011111111111"

​
accountType
enum<string>
required

Type of account

Available options:
PRIVATE,
LEGAL
Example:

"PRIVATE"

​
accountHolderName
string
required

Name of the account holder

Example:

"Jane Doe"

​
status
enum<string>
required

Account status

Available options:
OPEN,
CLOSED
Example:

"OPEN"

​
createdAt
string
required

Account creation timestamp

Example:

"2025-09-10T13:43:40.758Z"

​
updatedAt
string
required

Last update timestamp

Example:

"2025-09-10T13:55:40.758Z"

​
ibanMetadata
object

International Bank Account Generation Metadata

​
accountHolderNameAliases
string[] | null

Optional alternative names or identifiers to improve matching (e.g., acronyms, short forms like "IBM" for "International Business Machines")

Example:
["HGRP"]
​
organisationIdentification
object

Organisation identification details (for LEGAL accounts)