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",
  "url": "/api/v1/transactions",
  "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
​
url
string
required

The canonical path of the collection, relative to the API host. Useful for logging, debugging, and generic pagination utilities that do not need to be aware of the specific endpoint.

Example:

"/api/v1/transactions"

​
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.