List transactions

GET https://api.invunion.com/api/v1/transactions transactions:read Markdown

List bank transactions for the authenticated tenant.

Returns a paginated list of transactions. Default scope is settlement (eligible for invoice matching). Amounts are always positive; direction is separate. Each item includes catalog payment-method codes and the own account the movement was retrieved on.

Query parameters

Name	Type	Required
`page` Page number. Default 1. Example: 1	integer	Optional
`pageSize` Page size. Default 20, maximum 100. Example: 20	integer	Optional
`sortBy` Sort column. Default transaction_date. Unknown values fall back to transaction_date.	string No maximum	Optional
Allowed values`transaction_dateamountadded_atbooking_datestatusremaining_amountdescription_displaydescription_original`
`sortOrder` Sort direction. Default desc. Allowed values`ascdesc`	string No maximum	Optional
`startDate` Inclusive start of transaction_date (YYYY-MM-DD). Example: 2026-09-01	string No maximum	Optional
`endDate` Inclusive end of transaction_date (YYYY-MM-DD). Example: 2026-09-30	string No maximum	Optional
`status` Single status, comma-separated list, or to_match (unmatched, unconsidered, and pending).	string No maximum	Optional
Allowed values`unconsideredunmatchedmatchedignoredpendingpartialto_match`
`direction` Payment direction. Amounts are always positive. Allowed values`inout`	string No maximum	Optional
`flowType` Economic flow type.	string No maximum	Optional
Allowed values`paymentrefundfeechargebackpayoutdirect_debittransferadjustmentother`
`scope` Settlement eligibility. Default settlement.	string No maximum	Optional
Allowed values`settlementallout_of_scope`
`counterpartyId` Filter by counterparty code (`account_code`). Example: CPT-042	string No maximum	Optional
`paymentMethodId` Filter by catalog payment-method code (`PM-NNN`). Example: PM-001	string No maximum	Optional
`ownAccountId` Filter by the tenant own bank account the movement was retrieved on (`code`). Example: PM-001	string No maximum	Optional
`paymentMethod` Payment channel on the transaction, not the catalog instrument type.	string No maximum	Optional
Allowed values`cardtransferdirect_debitcashcheckcryptoother`
`paymentContext` Payment context.	string No maximum	Optional
Allowed values`CITMITrecurringone_timerefundother`
`search` Case-insensitive match on descriptions, counterparty name, or external_reference. Example: Leones	string Max 100	Optional
`externalReference` Exact external reference. Example: INV-2026-0042	string Max 255	Optional
`currency` ISO 4217 currency code. Example: EUR	string Max 3	Optional
`minAmount` Minimum amount (always positive). Example: 100	number	Optional
`maxAmount` Maximum amount (always positive). Example: 5000	number	Optional
`hasRemaining` If true, only transactions with remaining_amount > 0. false is accepted and ignored. Allowed values`truefalse`	boolean	Optional

Errors

This operation can return the following errors in addition to generic HTTP failures.

Error	HTTP code	Description
`Missing Bearer token`	401	The Authorization header is missing or is not a Bearer token.
`Invalid or revoked API key`	401	The API key is unknown, malformed, expired, or has been revoked.
`API key is missing scope transactions:read`	403	The key does not include transactions:read. A write scope does not imply the matching read scope.
`Too many requests, please try again later`	429	Wait and retry. The Retry-After header is the number of seconds to wait.
`Invalid query parameters`	400	A query value failed validation. details lists field and message.
`Tenant ID required`	400	The authenticated credential is not bound to a tenant.
`Internal server error`	500	Unexpected server error. The JSON body includes correlationId. Retry with backoff.

Previous: Unlink counterparty Next: Get transaction

Request

Requests in the examples call https://api.invunion.com/api/v1/transactions.

curl --request GET \
  --url https://api.invunion.com/api/v1/transactions?page=1&pageSize=20&scope=settlement \
  --header 'accept: application/json' \
  --header 'authorization: Bearer uk_live_YOUR_API_KEY'

import requests

url = "https://api.invunion.com/api/v1/transactions?page=1&pageSize=20&scope=settlement"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY",
}
response = requests.get(url, headers=headers)
print(response.json())

require 'net/http'
require 'json'
require 'uri'

uri = URI("https://api.invunion.com/api/v1/transactions?page=1&pageSize=20&scope=settlement")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Accept'] = 'application/json'
request['Authorization'] = 'Bearer uk_live_YOUR_API_KEY'
response = http.request(request)
puts response.body

const response = await fetch("https://api.invunion.com/api/v1/transactions?page=1&pageSize=20&scope=settlement", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY"
  },
});
const data = await response.json();

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.invunion.com/api/v1/transactions?page=1&pageSize=20&scope=settlement", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer uk_live_YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

const response = await fetch("https://api.invunion.com/api/v1/transactions?page=1&pageSize=20&scope=settlement", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY"
  },
});
console.log(await response.json());

200

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "2d0e6679-7425-40de-944b-e07fc1f90ae7",
        "tenant_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "transaction_code": "TX-8891",
        "counterparty_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "payment_method_id": "8a1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
        "amount": 1000,
        "direction": "in",
        "flow_type": "payment",
        "currency": "EUR",
        "transaction_date": "2026-09-12T00:00:00.000Z",
        "booking_date": "2026-09-12T00:00:00.000Z",
        "value_date": "2026-09-12T00:00:00.000Z",
        "payment_method": "transfer",
        "external_reference": "INV-2026-0042",
        "remittance_info": "INV-2026-0042 Leones Cars",
        "description_original": "VIREMENT LEONES CARS",
        "description_display": "Leones Cars — wire payment",
        "counterparty_name": "Leones Cars",
        "counterparty_iban": "FR7630006000011234567890189",
        "counterparty_bic": "BNPAFRPP",
        "allocated_amount": 1000,
        "remaining_amount": 0,
        "status": "matched",
        "in_settlement_scope": true,
        "counterparty_name_display": "Leones Cars",
        "payment_method_code": "PM-001",
        "payment_method_name": "Leones Cars EUR",
        "own_account_iban": "FR7612345678901234567890123",
        "created_at": "2026-09-12T08:12:00.000Z",
        "updated_at": "2026-09-12T09:00:00.000Z"
      },
      {
        "id": "7d9c13e4-3a06-4f81-ca03-104f7b2d95c3",
        "tenant_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "transaction_code": "TX-8892",
        "counterparty_id": "4b7a91c2-18e4-4d6f-a8c1-9e2d5f0b73a1",
        "payment_method_id": "6c8b02d3-29f5-4e70-b9d2-0f3e6a1c84b2",
        "amount": 4200,
        "direction": "out",
        "flow_type": "payment",
        "currency": "USD",
        "transaction_date": "2026-09-08T00:00:00.000Z",
        "booking_date": "2026-09-08T00:00:00.000Z",
        "value_date": "2026-09-08T00:00:00.000Z",
        "payment_method": "other",
        "external_reference": "PO-1904",
        "remittance_info": "Grove Street parts",
        "description_original": "PAYPAL GROVE STREET GARAGE",
        "description_display": "Grove Street Garage — PayPal",
        "counterparty_name": "Grove Street Garage",
        "counterparty_iban": null,
        "counterparty_bic": null,
        "allocated_amount": 4200,
        "remaining_amount": 0,
        "status": "matched",
        "in_settlement_scope": true,
        "counterparty_name_display": "Grove Street Garage",
        "payment_method_code": "PM-002",
        "payment_method_name": "Grove Street Garage PayPal",
        "own_account_iban": "FR7612345678901234567890123",
        "created_at": "2026-09-08T14:10:00.000Z",
        "updated_at": "2026-09-08T14:10:00.000Z"
      }
    ],
    "total": 2,
    "page": 1,
    "pageSize": 20,
    "hasMore": false,
    "scope": "settlement",
    "outOfScopeCount": 3
  }
}