List transactions

GET

transactions

List transactions

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

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

fetch('https://app.finta.com/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://app.finta.com/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://app.finta.com/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://app.finta.com/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.

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.

List transactions

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

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

fetch('https://app.finta.com/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://app.finta.com/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://app.finta.com/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://app.finta.com/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

Departments

Integrations

Aggregations

Transactions

Journal Entries

Parties

Reports

List transactions

Authorizations

Query Parameters

Response