Skip to main content
GET
/
transactions
List transactions
curl --request GET \
  --url https://app.finta.com/api/v1/transactions \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "has_more": true,
  "next_cursor": "txn_h8i9j0k1l2m3n4",
  "data": [
    {
      "id": "txn_a1b2c3d4e5f6g7",
      "object": "transaction",
      "date": "2026-02-15",
      "accounting_date": "2026-02-15",
      "amount_cents": -49900,
      "currency": "USD",
      "merchant": "AWS",
      "description": null,
      "categorized": true,
      "category_id": "cat_v5e6f7g8h9i0j1",
      "category_name": "Software",
      "transaction_type": "standard",
      "source": {
        "vendor": "mercury",
        "type": "bank",
        "account_name": "Mercury Checking"
      },
      "status": "approved",
      "spread": null,
      "transfer_id": null,
      "created": 1771183600
    },
    {
      "id": "txn_h8i9j0k1l2m3n4",
      "object": "transaction",
      "date": "2026-02-14",
      "accounting_date": "2026-02-14",
      "amount_cents": -85000,
      "currency": "USD",
      "merchant": "WeWork",
      "description": null,
      "categorized": true,
      "category_id": "cat_c9d0e1f2g3h4i5",
      "category_name": "Office",
      "transaction_type": "standard",
      "source": {
        "vendor": "mercury",
        "type": "bank",
        "account_name": "Mercury Checking"
      },
      "status": "approved",
      "spread": null,
      "transfer_id": null,
      "created": 1771027200
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key prefixed with finta_

Query Parameters

​
limit
integer
default:100

Maximum number of results to return (1-500). Defaults to 100.

Required range: 1 <= x <= 500
​
starting_after
string

A cursor for pagination. Pass the next_cursor value from a previous response to fetch the next page.

​
status
enum<string>

Filter by approval status. If omitted, returns both approved and pending transactions.

Available options:
approved,
pending
​
start_date
string<date>

Return transactions on or after this date (YYYY-MM-DD). If omitted, no lower bound.

​
end_date
string<date>

Return transactions on or before this date (YYYY-MM-DD). If omitted, no upper bound.

Response

A paginated list of transactions

​
object
enum<string>
required
Available options:
list
​
has_more
boolean
required

Whether there are more results beyond this page.

​
data
object[]
required
​
next_cursor
string | null

Pass this value as starting_after to fetch the next page. Null when has_more is false.