Financial statements

Get income statement (as-reported)

Returns the statement exactly as the filing presents it, read from the rendered statement files SEC EDGAR generates from that filing’s own XBRL presentation linkbase (go/service/asreported.go). The line_items tree is the filing’s real hierarchy: a heading row carries value null and its rows as children.

Structural parity, not label parity. Financial Datasets normalizes some labels where this server prints what the filing prints: Apple’s FY2025 income statement says “Gross margin” where they say “Gross Profit”. full_label carries the row’s XBRL element name on both, so it agrees either way. Verified against their own as-reported output for AAPL FY2025: balance-sheet values agree 19 of 19, cash flow 11 of 11.

ticker is required. Both EDGAR fetches route through Monid, so they bill the caller’s wallet and write receipts like every other upstream call.

GET

financials

income-statements

as-reported

Get income statement (as-reported)

curl --request GET \
  --url https://financialdatasets.rip/financials/income-statements/as-reported \
  --header 'X-API-KEY: <api-key>'

import requests

url = "https://financialdatasets.rip/financials/income-statements/as-reported"

headers = {"X-API-KEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financials/income-statements/as-reported', 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/income-statements/as-reported",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/financials/income-statements/as-reported"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	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://financialdatasets.rip/financials/income-statements/as-reported")

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

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

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

{
  "income_statements": [
    {
      "ticker": "<string>",
      "report_period": "2023-12-25",
      "fiscal_period": "FY2025",
      "period": "annual",
      "currency": "<string>",
      "accession_number": "<string>",
      "filing_url": "<string>",
      "line_items": [
        {
          "label": "<string>",
          "full_label": "<string>",
          "value": 123,
          "children": "<array>"
        }
      ]
    }
  ],
  "next_page_url": "<string>"
}

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.

Query Parameters

ticker

string

Ticker of the issuer. Required.

period

enum<string>

default:annual

annual reads the 10-K, quarterly the 10-Q.

Available options:

annual,

quarterly

limit

integer

default:1

Number of filings to return (default: 1).

Required range: 1 <= x <= 50

cik

string

SEC CIK. Accepted for parity; this route resolves the CIK from the filing itself.

report_period

string<date>

Restricts to the period whose report_period equals this date (YYYY-MM-DD).

report_period_gte

string<date>

Restricts to periods ending on or after this date.

report_period_lte

string<date>

Restricts to periods ending on or before this date.

cursor

string

Opaque base64url pagination cursor.

Response

As-filed statement, nested as the filing presents it.

As-reported envelope: {"income_statements": [...]}. The key matches the normalized route, so a client that only changed its base URL reads the same field.

income_statements

AsReportedStatement · object[]

required

Show child attributes

next_page_url

string

Get income statement (as-reported)

curl --request GET \
  --url https://financialdatasets.rip/financials/income-statements/as-reported \
  --header 'X-API-KEY: <api-key>'

import requests

url = "https://financialdatasets.rip/financials/income-statements/as-reported"

headers = {"X-API-KEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financials/income-statements/as-reported', 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/income-statements/as-reported",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/financials/income-statements/as-reported"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	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://financialdatasets.rip/financials/income-statements/as-reported")

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

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

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

{
  "income_statements": [
    {
      "ticker": "<string>",
      "report_period": "2023-12-25",
      "fiscal_period": "FY2025",
      "period": "annual",
      "currency": "<string>",
      "accession_number": "<string>",
      "filing_url": "<string>",
      "line_items": [
        {
          "label": "<string>",
          "full_label": "<string>",
          "value": 123,
          "children": "<array>"
        }
      ]
    }
  ],
  "next_page_url": "<string>"
}

Financial statements

Financial metrics

Earnings

Filings

Prices

News

Insider trades

Screener

Company

KPIs

Not implemented

Macroeconomics

Index funds

Institutional holdings

Ownership

Get income statement (as-reported)

Authorizations

Query Parameters

Response