Plans & billing

Retrieve usage

Returns how much of each limit the authenticated company has used. These are the counts and limits Finta enforces, including any limit Finta raised for the company, not the plan’s advertised ones. stopped is true when Finta has stopped because of the limit, as its banners show. Monthly counts reset at midnight Pacific on resets_on; the transaction limit is a stored total and never resets. A null limit means there is none, as on Enterprise. Counts can lag by a few minutes. This endpoint doesn’t count toward the monthly API limit and keeps answering after that limit is reached, so api_calls.stopped can be read at the limit.

GET

usage

Retrieve usage

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

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

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

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

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": "usage",
  "categorizations": {
    "used": 2712,
    "limit": 3000,
    "held": 0,
    "stopped": false,
    "resets_on": "2026-11-01"
  },
  "transactions": {
    "used": 41380,
    "limit": 100000,
    "held": 0,
    "stopped": false,
    "resets_on": null
  },
  "ai_credits": {
    "used": 22,
    "limit": 30,
    "remaining": 8,
    "stopped": false,
    "resets_on": "2026-11-01"
  },
  "api_calls": {
    "used": 12,
    "limit": 300,
    "custom_limit": false,
    "stopped": false,
    "resets_on": "2026-11-01"
  },
  "mcp_calls": {
    "used": 214,
    "limit": 300,
    "custom_limit": false,
    "stopped": false,
    "resets_on": "2026-11-01"
  }
}

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Response

The company's usage

object

enum<string>

required

Available options:

usage

categorizations

object

required

Automatic categorizations this month, or transactions stored in total.

Show child attributes

transactions

object

required

Automatic categorizations this month, or transactions stored in total.

Show child attributes

ai_credits

object

required

AI credits used this month against the monthly allowance.

Show child attributes

api_calls

object

required

Public API requests or MCP tool calls this month.

Show child attributes

mcp_calls

object

required

Public API requests or MCP tool calls this month.

Show child attributes

Retrieve usage

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

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

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

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

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": "usage",
  "categorizations": {
    "used": 2712,
    "limit": 3000,
    "held": 0,
    "stopped": false,
    "resets_on": "2026-11-01"
  },
  "transactions": {
    "used": 41380,
    "limit": 100000,
    "held": 0,
    "stopped": false,
    "resets_on": null
  },
  "ai_credits": {
    "used": 22,
    "limit": 30,
    "remaining": 8,
    "stopped": false,
    "resets_on": "2026-11-01"
  },
  "api_calls": {
    "used": 12,
    "limit": 300,
    "custom_limit": false,
    "stopped": false,
    "resets_on": "2026-11-01"
  },
  "mcp_calls": {
    "used": 214,
    "limit": 300,
    "custom_limit": false,
    "stopped": false,
    "resets_on": "2026-11-01"
  }
}

API Reference

Taxes

Files

Company

Plans & billing

Team

Categories

Rules

Departments

Integrations

Aggregations

Transactions

Forms

Journal Entries

Invoices

Parties

Reports

Feedback

Tax Credits

Retrieve usage

Authorizations

Response