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",
  "total": 1250,
  "has_more": true,
  "data": [
    {
      "id": "txn_a1b2c3d4e5f6g7",
      "object": "transaction",
      "date": "2026-02-15",
      "merchant": "AWS",
      "amount": -499,
      "currency": "USD",
      "account": "Business Checking",
      "source": "Mercury",
      "approved": true,
      "category": {
        "id": "cat_o5p6q7r8s9t0u1",
        "name": "Software"
      },
      "created": 1771113600
    },
    {
      "id": "txn_h8i9j0k1l2m3n4",
      "object": "transaction",
      "date": "2026-02-14",
      "merchant": "WeWork",
      "amount": -850,
      "currency": "USD",
      "account": "Business Checking",
      "source": "Mercury",
      "approved": true,
      "category": {
        "id": "cat_c9d0e1f2g3h4i5",
        "name": "Office"
      },
      "created": 1771027200
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key prefixed with finta_

Query Parameters

​
limit
integer
default:25

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

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of results to skip for pagination. Defaults to 0.

Required range: x >= 0
​
approved
enum<string>

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

Available options:
true,
false
​
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
​
total
integer
required

Total number of results matching the query.

​
has_more
boolean
required

Whether there are more results beyond this page.

​
data
object[]
required