Transactions

Query for bank account transactions.

GET Transactions

POST https://api.finqware.com/v1/transactions/get

Get transaction data related to a certain credentials_id.

Request Body

Name	Type	Description
client_id*	string	An identifier for your tenant app.
client_secret*	string	A tenant app secret.
credentials_id*	string	A pointer to a consent record created via an onboarding session.
access_token*	string	An authorization key for this particular consent record.
tenant_user_id*	string	A unique identifier for your end-user.
filter	object	A filter object. Criteria in the table below.

200: OK A list of bank account transactions and related info.

[
  {
    "account_id": "91ba3b32-...-6b41bf682aa8",
    "timestamp": "2021-02-01T13:14:52Z",
    "id": "99459ac2-a7b3-11e9-b37d-bfb2bf7bff33",
    "utx_id": "Jd+ErYeFaUOWzU37k9y1+fHz/+4v/YwQ/fq8A4jbSjc=",
    
    "data": {
      "amount": "4.27",
      "balance": "9434.52",
      "booking_date_time": "2019-05-11T07:57:00Z",
      "credit_debit_indicator": "debit",
      "currency": "RON",
      "info": "Currency payment or withdrawal",
      "status": "booked",

      // future use
      "details": null,
      "exchange_rate": null
    }
  }
]

400: Bad Request

{
    "message": "Error message"
}

Filter element	Type	Info
account_id	string	finqware id of the bank account
currency	string	eg: RON
status	string	eg: booked
credit_debit_indicator	string	debit | credit
category	string	eg: shopping
eq	decimal	amount equal to
gte	decimal	amount >= than
gt	decimal	amount > than
lte	decimal	amount <= than
lt	decimal	amount < than
booking_date_eq	utc_datetime	date equal to
booking_date_gte	utc_datetime	date later or equal to
booking_date_gt	utc_datetime	later than
booking_date_lte	utc_datetime	earlier or equal to
booking_date_lt	utc_datetime	earlier than
timestamp_eq	utc_datetime	timestamp equal to
timestamp_gte	utc_datetime	timestamp later or equal to
timestamp_gt	utc_datetime	timestamp later than
timestamp_lte	utc_datetime	timestamp earlier or equal to
timestamp_lt	utc_datetime	timestamp earlier than

The timestamp represents the time the transaction was inserted in Finqware's database.

// Filter example

"filter": {
  "account_id": "91ba3b32-...-6b41bf682aa8",
  "lt": 4.2700000000000001,
  "booking_date_gt": "2025-05-03T00:00:00Z",
  "timestamp_gte": "2025-05-11T00:00:00Z"
}

For each transaction Finqware calculates an unique transaction id (utx_id) that is the same across consents. Make sure you always use this id in order to decide if you need to update or insert a record. If you already syncronised and inserted in your DB a certain transaction record and you receive it again, you can update the existing record, not insert it again.