Transactions

List accounts

Lists the authenticated company’s locally known transaction-source accounts using stable, opaque acct_ IDs, including accounts without transactions and retained accounts whose provider records were deleted. Includes bank, credit, and synthetic sources; these are not chart-of-accounts categories. Inventory does not imply current connectivity or complete remote-provider coverage. Requires API access and Transactions: View.

Results are ordered by identity creation order (oldest first), independent of labels. Pagination is not a frozen snapshot. An empty inventory returns data: [], has_more: false, and next_cursor: null. There are no account filters or request body.

Labels and source types use synchronized metadata; retained accounts expose their last known values. GET never backfills identities or changes bookkeeping. Standard API usage logging, subscription checks, rate limits, and usage limits still apply. Missing identities require operational backfill/readiness before discovery is enabled.

GET

accounts

List accounts

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

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

fetch('https://finta.lol/api/v1/accounts', 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/accounts",
  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/accounts"

	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/accounts")

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": "<string>",
  "has_more": true,
  "next_cursor": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "account",
      "account_name": "<string>",
      "vendor": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Query Parameters

limit

integer

default:100

Required range: 1 <= x <= 500

starting_after

string

Pass the previous next_cursor unchanged and URL-encode it. Do not pass an account ID. Cursors are bound to the authenticated company and account collection. Malformed and foreign cursors return the same generic 400 invalid_request error.

Response

Account inventory.

object

enum<string>

required

Available options:

list

url

string

required

has_more

boolean

required

Whether another page is available after the returned accounts.

next_cursor

string | null

required

Opaque cursor for starting_after; null on the final or empty page. Bound to this company and account collection.

data

object[]

required

Known account identities, oldest first; empty when no identities are available.

Show child attributes

List accounts

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

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

fetch('https://finta.lol/api/v1/accounts', 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/accounts",
  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/accounts"

	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/accounts")

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": "<string>",
  "has_more": true,
  "next_cursor": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "account",
      "account_name": "<string>",
      "vendor": "<string>",
      "type": "<string>"
    }
  ]
}

API Reference

Company

Team

Categories

Rules

Departments

Integrations

Aggregations

Transactions

Journal Entries

Parties

Reports

List accounts

Authorizations

Query Parameters

Response