GET /service/accounts

List accounts

Retrieves list of accounts for a given consent.

Query Parameters

consentId ConsentId

Consent id

iban IBAN

Possible values: >= 15 characters and <= 34 characters

Consent source IBAN account number

cursor string

Responses

• 200
• 401
• 404

---

Default response

application/json

Schema

Example (from schema)

---

Schema

data object[]
Array [
id AccountId
Unique account id
consentId ConsentId
Unique consent id
providerId ProviderId
Unique payment provider (bank) id
country CountryCode
Provider country code (ISO 3166 alpha-2 codes)
name string
Name of account
holder string
Name of account holder/owner
nature string
The type of account, ie. credit card, checking ...
balance decimal
Amount of transaction in format: 0.00 without thousand separator, exact to two decimal places.
NOTE: If amount is provided with more than two decimal places then amount will be rounded to two decimal paces.
balanceUpdated date-time
RFC 3339 date time format (2007-11-06T16:34:41.000Z)
currency CurrencyCode
ISO 4217 currency code.
iban IBAN
Possible values: >= 15 characters and <= 34 characters
IBAN account number with country prefix
created date-time
RFC 3339 date time format (2007-11-06T16:34:41.000Z)
modified date-time
RFC 3339 date time format (2007-11-06T16:34:41.000Z)
]
metadata object
next_cursor string

{
  "data": [
    {
      "id": "111",
      "consentId": "123",
      "providerId": "string",
      "country": "AT",
      "name": "string",
      "holder": "string",
      "nature": "string",
      "balance": 12.3,
      "balanceUpdated": "2025-10-30T15:47:48.764Z",
      "currency": "EUR",
      "iban": "AT483200000012345865",
      "created": "2025-10-30T15:47:48.764Z",
      "modified": "2025-10-30T15:47:48.764Z"
    }
  ],
  "metadata": {
    "next_cursor": "string"
  }
}

Unauthorized

application/json

Schema

Example (from schema)

Example

---

Schema

errorMessage string required

Description of error

errorCode ErrorCode required

Possible values: [invalid_parameter, unauthorized, forbidden, not_found, not_allowed, bad_request, other]

Error code of a specific error. For more details visit https://documentation.fliqa.io/api/errors/{errorCode}

errorSubCode ErrorSubCode

Possible values: [api_key_secret_header_must_be_provided, authorization_header_must_be_provided, access_not_allowed, domain_not_allowed, access_token_expired, invalid_access_scope, not_authorized, phone_or_email_not_registered, phone_number_start_with_plus_and_country, phone_number_invalid, email_invalid, email_or_phone_number_required, invalid_pin, could_not_interpret_numbers_after_plus, supplied_string_not_phone_number, string_supplied_too_short_to_be_phone_number, string_supplied_too_long_to_be_phone_number, string_supplied_was_too_long_to_parse, unspecified]

Error sub code of a specific error. For more details visit https://documentation.fliqa.io/api/errors/{errorCode}#{errorSubCode}

documentationUrl uri

Link to documentation if available, typically https://documentation.fliqa.io/api/errors/{errorCode}

requestId RequestId

Unique request id

resourceId ResourceId

Unique resource id

{
  "errorMessage": "string",
  "errorCode": "unauthorized",
  "errorSubCode": "phone_or_email_not_registered",
  "documentationUrl": "string",
  "requestId": "554099e7d0b648d7b96bc31c148425b8",
  "resourceId": "9c14c6f2f0ee4a54a280be3c18ec1dba"
}

{
  "errorCode": "unauthorized",
  "errorMessage": "Not authorized",
  "documentationUrl": "https://documentation.fliqa.io/api/errors/unauthorized"
}

Consent not found

application/json

Schema

Example (from schema)

Example

---

Schema

errorMessage string required

Description of error

errorCode ErrorCode required

Possible values: [invalid_parameter, unauthorized, forbidden, not_found, not_allowed, bad_request, other]

Error code of a specific error. For more details visit https://documentation.fliqa.io/api/errors/{errorCode}

errorSubCode ErrorSubCode

Possible values: [api_key_secret_header_must_be_provided, authorization_header_must_be_provided, access_not_allowed, domain_not_allowed, access_token_expired, invalid_access_scope, not_authorized, phone_or_email_not_registered, phone_number_start_with_plus_and_country, phone_number_invalid, email_invalid, email_or_phone_number_required, invalid_pin, could_not_interpret_numbers_after_plus, supplied_string_not_phone_number, string_supplied_too_short_to_be_phone_number, string_supplied_too_long_to_be_phone_number, string_supplied_was_too_long_to_parse, unspecified]

Error sub code of a specific error. For more details visit https://documentation.fliqa.io/api/errors/{errorCode}#{errorSubCode}

documentationUrl uri

Link to documentation if available, typically https://documentation.fliqa.io/api/errors/{errorCode}

requestId RequestId

Unique request id

resourceId ResourceId

Unique resource id

{
  "errorMessage": "string",
  "errorCode": "unauthorized",
  "errorSubCode": "phone_or_email_not_registered",
  "documentationUrl": "string",
  "requestId": "554099e7d0b648d7b96bc31c148425b8",
  "resourceId": "9c14c6f2f0ee4a54a280be3c18ec1dba"
}

{
  "errorCode": "not_found",
  "errorMessage": "Can't find consent '123'",
  "documentationUrl": "https://documentation.fliqa.io/api/errors/not_found"
}

Loading...