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
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://www.finta.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Category Reference

Categories describe the economic classification of a transaction event.
Some category values use spaces instead of underscores (e.g., INTERCOMPANY TRANSFER, CLAIM REWARD). Always reference the exact values below.
CategoryDescription
DEPOSITInbound receipt of funds
WITHDRAWALOutbound transfer of funds
SWAPExchange of one asset for another
BRIDGECross-chain transfer
INTERCOMPANY TRANSFERTransfer between legal entities
INTERNAL TRANSFERTransfer within the same legal entity
FEENetwork gas, exchange, or service fee
MINTINGCreation of new tokens
STAKING_REWARDYield from staking
INVOICEPayment received against a customer invoice
BILLPayment against a vendor bill
CLAIM REWARDProtocol or ecosystem reward claim
BORROWBorrowing event
REPAYMENTLoan repayment
RESERVES CHANGETreasury reserves adjustment
REALIZED_PNLRealized profit or loss
NFTNFT mint, sale, or transfer
SPAMSpam/airdrop (auto-hides from accounting)
UNKNOWNUnclassified, pending review

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.