Metrics

List metric values

Returns key metrics with one row per month. Each row has point_in_time, holding its as_of date and the metrics read on that date, and period, holding its inclusive start_date and end_date and the metrics over those dates. A row holds only the requested metrics; null means a metric doesn’t apply to that month, as its definition in GET /metrics says.

Dates select whole months in America/Los_Angeles (Pacific Time): start_date moves to the first of its month and end_date to the end of its month, or to today for the current month. One request covers at most 36 months. The current month runs through today; its MoM and YoY growth compare its revenue so far with the whole earlier month, and its runway uses last month’s net income until the 5th, then its net income so far.

Revenue, expenses and net income can be added across months. Point-in-time values, percentages and runway can’t: year-end cash is the last month’s cash.

Revenue is before discounts, credits and refunds, and expenses include taxes, so both can differ from the sections of GET /reports/income_statement.

GET

metric_values

List metric values

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

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

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

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

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/metric_values",
  "group_by": "month",
  "start_date": "2026-09-01",
  "end_date": "2026-10-30",
  "currency": "USD",
  "metrics": [
    "cash_cents",
    "runway_months",
    "revenue_cents",
    "revenue_growth_mom_percent",
    "net_income_cents"
  ],
  "data": [
    {
      "object": "metric_values",
      "label": "2026-09",
      "point_in_time": {
        "as_of": "2026-09-30",
        "cash_cents": 98000000,
        "runway_months": 27
      },
      "period": {
        "start_date": "2026-09-01",
        "end_date": "2026-09-30",
        "revenue_cents": 8500000,
        "revenue_growth_mom_percent": 12,
        "net_income_cents": -3600000
      }
    },
    {
      "object": "metric_values",
      "label": "2026-10",
      "point_in_time": {
        "as_of": "2026-10-30",
        "cash_cents": 95100000,
        "runway_months": 26
      },
      "period": {
        "start_date": "2026-10-01",
        "end_date": "2026-10-30",
        "revenue_cents": 8900000,
        "revenue_growth_mom_percent": 5,
        "net_income_cents": -2900000
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Query Parameters

group_by

enum<string>

default:month

month, one row per month. The only grouping for now.

Available options:

month

metrics

string

required

Comma-separated metric keys from GET /metrics. Ask only for the metrics you need. Rows list them in catalog order.

start_date

string<date>

A calendar date (YYYY-MM-DD) in the first month. Defaults to end_date's month, so a request without dates returns the current month to date.

end_date

string<date>

A calendar date (YYYY-MM-DD) in the last month. Defaults to today.

Response

One row per month

object

enum<string>

required

Available options:

list

url

enum<string>

required

Available options:

/api/v1/metric_values

group_by

enum<string>

required

Available options:

month

start_date

string<date>

required

The first day of the first month.

end_date

string<date>

required

The last day of the last month, or today when the last month is the current one.

currency

enum<string>

required

ISO 4217 currency code for every amount in data.

Available options:

USD

metrics

string[]

required

The metric keys each row holds, in catalog order.

data

object[]

required

One row per month, oldest first.

Show child attributes

List metric values

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

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

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

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

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/metric_values",
  "group_by": "month",
  "start_date": "2026-09-01",
  "end_date": "2026-10-30",
  "currency": "USD",
  "metrics": [
    "cash_cents",
    "runway_months",
    "revenue_cents",
    "revenue_growth_mom_percent",
    "net_income_cents"
  ],
  "data": [
    {
      "object": "metric_values",
      "label": "2026-09",
      "point_in_time": {
        "as_of": "2026-09-30",
        "cash_cents": 98000000,
        "runway_months": 27
      },
      "period": {
        "start_date": "2026-09-01",
        "end_date": "2026-09-30",
        "revenue_cents": 8500000,
        "revenue_growth_mom_percent": 12,
        "net_income_cents": -3600000
      }
    },
    {
      "object": "metric_values",
      "label": "2026-10",
      "point_in_time": {
        "as_of": "2026-10-30",
        "cash_cents": 95100000,
        "runway_months": 26
      },
      "period": {
        "start_date": "2026-10-01",
        "end_date": "2026-10-30",
        "revenue_cents": 8900000,
        "revenue_growth_mom_percent": 5,
        "net_income_cents": -2900000
      }
    }
  ]
}

API Reference

Onboarding

Sheets

Taxes

Files

Company

Plans & billing

Team

Categories

Rules

Tags

Departments

Integrations

Inbox

Aggregations

Transactions

Forms

Reconciliation

Journal Entries

Invoices

Parties

Metrics

Reports

Feedback

Tax Credits

List metric values

Authorizations

Query Parameters

Response