Financial Datasets Get Income Statements

https://api.sandbase.ai/v1/api/financial-datasets/financials-income-statements

Get Income Statements from Financial Datasets. Returns the official Financial Datasets API response unchanged.

Price
$0.03USD / call
Method
POST
Response
JSON
Parameters
0 required · 18 optional
Production route

Try the model

Playground

Open playground
Input
The Central Index Key (CIK) of the company.
Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.
The exchange the ticker is listed on. Omit for US listings. Use `LSE` for the London Stock Exchange; any ticker of the company, including a second share class, returns the company's statements. Allowed values: LSE.
Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
The ISIN (International Securities Identification Number) of a non-US listing. An alternative to `ticker` and `exchange`.
The maximum number of income statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`. Provider reference (supplier schema): `{"format":"int32","type":"integer"}`.
market Allowed values: UK, US.
The time period of the income statements. Provider reference (supplier schema): `{"enum":["annual","quarterly","ttm"],"type":"string"}`.
Filter by exact report period date in YYYY-MM-DD format. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
Filter by report period greater than date in YYYY-MM-DD format. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
Filter by report period greater than or equal to date in YYYY-MM-DD format. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
Filter by report period less than date in YYYY-MM-DD format. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
Filter by report period less than or equal to date in YYYY-MM-DD format. Provider reference (supplier schema): `{"format":"date","type":"string"}`.
The ticker symbol. Required if cik or isin is not provided.
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.03 / run

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

cik
string · optional
cursor
string · optional
exchange
string (LSE) · optional
filing_date
string · optional
filing_date_gt
string · optional
filing_date_gte
string · optional
filing_date_lt
string · optional
filing_date_lte
string · optional
isin
string · optional
limit
string · optional
market
string (UK, US) · optional
period
string · optional
More
+6 optional parameters

Access

Provider
Financial Datasets
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/financial-datasets/financials-income-statements
Authentication
Bearer API key

API README

Financial Datasets Get Income Statements API

Get Income Statements from Financial Datasets. Returns the official Financial Datasets API response unchanged.

The response is the official Financial Datasets API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "financial-datasets/financials-income-statements"}'

Parameters

NameTypeRequiredDescription
cikstringNoThe Central Index Key (CIK) of the company.
cursorstringNoOpaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original reques
exchangestringNoThe exchange the ticker is listed on. Omit for US listings. Use LSE for the London Stock Exchange; any ticker of the company, including a second share class,
filing_datestringNoFilter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded. Provider reference (supplier schema): `{"format":"date","ty
filing_date_gtstringNoFilter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded. Provider reference (supplier schema): `{"format
filing_date_gtestringNoFilter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded. Provider reference (supplier schema
filing_date_ltstringNoFilter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded. Provider reference (supplier schema): `{"format":"
filing_date_ltestringNoFilter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the gi
isinstringNoThe ISIN (International Securities Identification Number) of a non-US listing. An alternative to ticker and exchange.
limitstringNoThe maximum number of income statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_u
marketstringNomarket
periodstringNoThe time period of the income statements. Provider reference (supplier schema): {"enum":["annual","quarterly","ttm"],"type":"string"}.
report_periodstringNoFilter by exact report period date in YYYY-MM-DD format. Provider reference (supplier schema): {"format":"date","type":"string"}.
report_period_gtstringNoFilter by report period greater than date in YYYY-MM-DD format. Provider reference (supplier schema): {"format":"date","type":"string"}.
report_period_gtestringNoFilter by report period greater than or equal to date in YYYY-MM-DD format. Provider reference (supplier schema): {"format":"date","type":"string"}.
report_period_ltstringNoFilter by report period less than date in YYYY-MM-DD format. Provider reference (supplier schema): {"format":"date","type":"string"}.
report_period_ltestringNoFilter by report period less than or equal to date in YYYY-MM-DD format. Provider reference (supplier schema): {"format":"date","type":"string"}.
tickerstringNoThe ticker symbol. Required if cik or isin is not provided.

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/financial-datasets/financials-income-statements
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/financial-datasets/financials-income-statements" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Financial Datasets$0.03 per callJSONOct 30, 2026
Financial Datasets$0.03 per callJSONOct 30, 2026
Financial Datasets$0.03 per callJSONOct 30, 2026
Financial Datasets$0.03 per callJSONOct 30, 2026
Financial Datasets$0.03 per callJSONOct 30, 2026
Financial Datasets$0.03 per callJSONOct 30, 2026

Questions

FAQ

How do I use the Financial Datasets Get Income Statements API?

Send a POST request to https://api.sandbase.ai/v1/api/financial-datasets/financials-income-statements with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Financial Datasets Get Income Statements API cost?

$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Financial Datasets Get Income Statements API accept?

No parameters are required. Optional: cik (string), cursor (string), exchange (one of LSE), filing_date (string), filing_date_gt (string) and filing_date_gte (string) and 12 more. The Parameters table and the Playground on this page list every field.

What does the Financial Datasets Get Income Statements API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Financial Datasets developer account or API key?

No. Financial Datasets Get Income Statements runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Financial Datasets API access separately.