Transactions

List transactions

Returns a paginated list of transactions for the authenticated company, ordered by date descending.

Transactions are raw bank/credit card activity. For accounting-level detail (double-entry debits and credits), see journal entries instead.

Keeping a local copy in sync

If you need to mirror this company’s transactions and pick up changes over time, use the updated_after parameter. It returns only transactions modified since your last sync, including deletions, so you don’t have to refetch everything. See that parameter for how to start and continue a sync.

For one-off questions (“what did we spend on AWS last month?”), leave out updated_after and use the regular filters.

GET

transactions

List transactions

curl --request GET \
  --url https://finta.lol/api/v1/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://finta.lol/api/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://finta.lol/api/v1/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://finta.lol/api/v1/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://finta.lol/api/v1/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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",
      "department_id": "dept_d4e5f6g7h8i9j0",
      "department_name": "Engineering",
      "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",
      "department_id": null,
      "department_name": null,
      "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

category_id

string

Filter by assigned category prefixed ID.

Pattern: ^cat_

transaction_type

enum<string>

Filter by public transaction type.

Available options:

standard,

transfer,

split

categorized

boolean

Filter by whether the transaction has been categorized.

merchant

string

Case-insensitive text search on merchant name.

source_vendor

string

Case-insensitive exact match on the integration or vendor name.

source_type

enum<string>

Case-insensitive exact match on the source account type.

Available options:

bank,

credit,

reimbursement

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.

updated_after

integer

Return only transactions modified after this Unix timestamp (seconds, not milliseconds), for keeping a local copy in sync without refetching everything. Supplying it changes the response in three ways: results are ordered oldest-modified first instead of by date, next_cursor becomes an opaque token rather than a transaction id, and deleted transactions are included with deleted: true so you can remove them from your copy. The response also carries a watermark — pass that value back as updated_after on your next sync rather than using your own clock. Page through until has_more is false, then store the watermark. Note this filters on when a transaction was last modified, which is unrelated to start_date/end_date, which filter on its date. Start a new mirror with updated_after=0, which matches every transaction: the initial load and every later sync then share one ordering and one cursor, and the watermark it returns joins them with no gap. Do not seed a mirror from the list without updated_after — it returns no watermark, leaving you to invent a starting point from your own clock, which is the drift this parameter exists to avoid. A sync from 0 also returns transactions deleted before you started, carrying deleted: true; you have no copy to remove, so skip them. Filters may be combined with updated_after and are applied normally, but know what you are getting. Filters match a transaction's current state, so a transaction that changes such that it no longer matches simply stops appearing — with no deleted tombstone, because it was not deleted. deleted: true is reported only for genuinely deleted transactions. If you are keeping a persistent mirror, that means your copy can only grow: rows enter correctly and never leave, and the drift is silent. Sync with updated_after alone and filter your own side. If you are answering a question rather than maintaining a copy, or filtering on something that cannot change (source_vendor, source_type), the combination is safe.

Example:

1771183600

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

Show child attributes

next_cursor

string | null

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

watermark

integer

Only present when updated_after was supplied. The server-generated Unix timestamp to pass as updated_after on your next sync. It is identical on every page of one sync; store it once you receive a page with has_more false.

Example:

1771183600

List transactions

curl --request GET \
  --url https://finta.lol/api/v1/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://finta.lol/api/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://finta.lol/api/v1/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://finta.lol/api/v1/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://finta.lol/api/v1/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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",
      "department_id": "dept_d4e5f6g7h8i9j0",
      "department_name": "Engineering",
      "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",
      "department_id": null,
      "department_name": null,
      "transaction_type": "standard",
      "source": {
        "vendor": "mercury",
        "type": "bank",
        "account_name": "Mercury Checking"
      },
      "status": "approved",
      "spread": null,
      "transfer_id": null,
      "created": 1771027200
    }
  ]
}

API Reference

Company

Team

Categories

Rules

Departments

Integrations

Aggregations

Transactions

Journal Entries

Parties

Reports

List transactions

Keeping a local copy in sync

Authorizations

Query Parameters

Response