Financial statements

Search financial statement line items across tickers

Searches an arbitrary set of statement field names (from IncomeStatement/BalanceSheet/CashFlowStatement) across an arbitrary, capped set of tickers, merging one row per (ticker, report_period) (go/service/searchlineitems.go). Reuses the same statement-matrix parsing get_income_statement/get_balance_sheet/get_cash_flow_statement build on, fetching all three statement kinds for every requested ticker and returning only the caller’s requested field names. limit bounds how many report periods each ticker contributes (most recent first) - Financial Datasets’ own schema does not say whether limit is per-ticker or global, and per-ticker is what every other limit in this API means. tickers is capped at 5 entries: each ticker is its own paid /equities/v1/statements call, so without a cap one request could turn into an unbounded spend.

POST

financials

line-items

curl --request POST \
  --url https://financialdatasets.rip/financials/search/line-items \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "line_items": [
    "revenue",
    "free_cash_flow"
  ],
  "tickers": [
    "AAPL"
  ],
  "period": "annual",
  "limit": 1
}
'

import requests

url = "https://financialdatasets.rip/financials/search/line-items"

payload = {
    "line_items": ["revenue", "free_cash_flow"],
    "tickers": ["AAPL"],
    "period": "annual",
    "limit": 1
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    line_items: ['revenue', 'free_cash_flow'],
    tickers: ['AAPL'],
    period: 'annual',
    limit: 1
  })
};

fetch('https://financialdatasets.rip/financials/search/line-items', 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://financialdatasets.rip/financials/search/line-items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'line_items' => [
        'revenue',
        'free_cash_flow'
    ],
    'tickers' => [
        'AAPL'
    ],
    'period' => 'annual',
    'limit' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://financialdatasets.rip/financials/search/line-items"

	payload := strings.NewReader("{\n  \"line_items\": [\n    \"revenue\",\n    \"free_cash_flow\"\n  ],\n  \"tickers\": [\n    \"AAPL\"\n  ],\n  \"period\": \"annual\",\n  \"limit\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://financialdatasets.rip/financials/search/line-items")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"line_items\": [\n    \"revenue\",\n    \"free_cash_flow\"\n  ],\n  \"tickers\": [\n    \"AAPL\"\n  ],\n  \"period\": \"annual\",\n  \"limit\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financials/search/line-items")

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

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"line_items\": [\n    \"revenue\",\n    \"free_cash_flow\"\n  ],\n  \"tickers\": [\n    \"AAPL\"\n  ],\n  \"period\": \"annual\",\n  \"limit\": 1\n}"

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

{
  "search_results": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-30",
      "period": "annual",
      "revenue": 416161000000,
      "free_cash_flow": 98767000000
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Body

application/json

POST body for /financials/search/line-items (search_line_items).

line_items

string[]

required

Statement field names to search for (e.g. "revenue", "total_assets", "free_cash_flow") - any field name IncomeStatement/BalanceSheet/CashFlowStatement declare. Required; at least one entry.

Minimum array length: 1

tickers

string[]

required

Tickers to search across. Required; 1-5 entries, no duplicates (each is its own paid /equities/v1/statements call, so this is capped to bound spend).

Required array length: 1 - 5 elements

period

enum<string>

default:ttm

Reporting period. Default "ttm", matching search_line_items' own default.

Available options:

annual,

quarterly,

ttm

limit

integer

default:1

Report periods per ticker, most recent first (default 1, max 100).

Required range: 1 <= x <= 100

Response

One row per (ticker, report_period). Real AAPL FY2025 revenue/free_cash_flow values captured from our own live API (docs/our-live-samples/income_statements.json, cash_flow.json). Never paginated (no next_page_url; use limit to bound the result set per ticker).

search_line_items envelope: {"search_results": [...]}. Never paginated (no next_page_url; use limit to bound the result set per ticker).

search_results

LineItemSearchRow · object[]

required

Show child attributes

Search financial statement line items across tickers

curl --request POST \
  --url https://financialdatasets.rip/financials/search/line-items \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "line_items": [
    "revenue",
    "free_cash_flow"
  ],
  "tickers": [
    "AAPL"
  ],
  "period": "annual",
  "limit": 1
}
'

import requests

url = "https://financialdatasets.rip/financials/search/line-items"

payload = {
    "line_items": ["revenue", "free_cash_flow"],
    "tickers": ["AAPL"],
    "period": "annual",
    "limit": 1
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    line_items: ['revenue', 'free_cash_flow'],
    tickers: ['AAPL'],
    period: 'annual',
    limit: 1
  })
};

fetch('https://financialdatasets.rip/financials/search/line-items', 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://financialdatasets.rip/financials/search/line-items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'line_items' => [
        'revenue',
        'free_cash_flow'
    ],
    'tickers' => [
        'AAPL'
    ],
    'period' => 'annual',
    'limit' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://financialdatasets.rip/financials/search/line-items"

	payload := strings.NewReader("{\n  \"line_items\": [\n    \"revenue\",\n    \"free_cash_flow\"\n  ],\n  \"tickers\": [\n    \"AAPL\"\n  ],\n  \"period\": \"annual\",\n  \"limit\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://financialdatasets.rip/financials/search/line-items")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"line_items\": [\n    \"revenue\",\n    \"free_cash_flow\"\n  ],\n  \"tickers\": [\n    \"AAPL\"\n  ],\n  \"period\": \"annual\",\n  \"limit\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financials/search/line-items")

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

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"line_items\": [\n    \"revenue\",\n    \"free_cash_flow\"\n  ],\n  \"tickers\": [\n    \"AAPL\"\n  ],\n  \"period\": \"annual\",\n  \"limit\": 1\n}"

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

{
  "search_results": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-30",
      "period": "annual",
      "revenue": 416161000000,
      "free_cash_flow": 98767000000
    }
  ]
}

Financial statements

Financial metrics

Earnings

Filings

Prices

News

Insider trades

Screener

Company

KPIs

Not implemented

Macroeconomics

Index funds

Institutional holdings

Ownership

Search financial statement line items across tickers

Authorizations

Body

Response