GET /service/accounts/:accountId/transactions

List transactions

Get transactions for account if allowed by the scope of the consent, sorted from latest to oldest

Path Parameters

accountId AccountId required

Get list of transactions for given account (if allowed by the consent scope)

Query Parameters

consentId ConsentId required

Consent id

from date-time

From transaction booked time (including) if not given the last transaction is first

until date-time

Until transaction booked time (excluding)

cursor string

Responses

• 200
• 401
• 404

---

List of transactions

application/json

Schema

Example (from schema)

---

Schema

data object[]
Array [
id TransactionId
Unique transaction id
created date-time
RFC 3339 date time format (2007-11-06T16:34:41.000Z)
executed date-time
RFC 3339 date time format (2007-11-06T16:34:41.000Z)
accountId AccountId
Unique account id
description string
Transaction description
details object
reference string
Transaction reference if available
description string
Additional transaction description
source string
Transaction source name or other info if available
target string
Transaction target name or other info if available
exchange object
Currency exchange rate if applicable to transaction
source CurrencyCode
ISO 4217 currency code.
target CurrencyCode
ISO 4217 currency code.
unit CurrencyCode
ISO 4217 currency code.
exchangeRate 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.
amount 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.
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.
currency CurrencyCode
ISO 4217 currency code.
status AccountTransactionStatus
Possible values: [booked, pending]
Account transaction status (booked or pending).
source IBAN
Possible values: >= 15 characters and <= 34 characters
IBAN account number with country prefix
target IBAN
Possible values: >= 15 characters and <= 34 characters
IBAN account number with country prefix
categorization object
code string
Possible values: <= 4 characters
Transaction category code (based on ISO 18245:2023 merchant category codes). As recognized by our categorization engine.
description string
Possible values: <= 512 characters
Transaction category description as recognized by our categorization engine. Not necessary coinciding with the recognized category code.
groupId integer
Transaction category group id category code belong to
groupDescription string
Transaction category group description
]
metadata object
next_cursor string

{
  "data": [
    {
      "id": "string",
      "created": "2025-10-30T15:47:48.765Z",
      "executed": "2025-10-30T15:47:48.765Z",
      "accountId": "111",
      "description": "string",
      "details": {
        "reference": "string",
        "description": "string",
        "source": "string",
        "target": "string",
        "exchange": {
          "source": "EUR",
          "target": "EUR",
          "unit": "EUR",
          "exchangeRate": 12.3
        }
      },
      "amount": 12.3,
      "balance": 12.3,
      "currency": "EUR",
      "status": "booked",
      "source": "AT483200000012345865",
      "target": "AT483200000012345865",
      "categorization": {
        "code": "string",
        "description": "string",
        "groupId": 0,
        "groupDescription": "string"
      }
    }
  ],
  "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"
}

Account 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 account '123'",
  "documentationUrl": "https://documentation.fliqa.io/api/errors/not_found"
}

Loading...