GET /v3/companies/{cik_or_ticker}/balance-sheet
Get a company's balance sheet by year or quarter.
Periods are fiscal year ends or quarter ends. You get standardized fields in a fixed order, as line_items {concept, label, unit, accuracy, values[]}. Each value has its period, status, source filing (accession_number, form_type, filing_date) and, when derived (Q4 = FY - 9M, ttm = the four quarters), its formula. A blank is never a zero. A line with no value in the periods is left out. accuracy gives the field's measured precision and coverage.
API key: required. See Authentication.
Group: Financial data (XBRL)
Try it
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/companies/AAPL/balance-sheet",
params={"period": "annual", "limit": "2"},
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())Response
Nothing has been sent yet.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
cik_or_ticker | path | string | yes | The company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK. | |
period | query | string | no | annual | annual (fiscal year ends) or quarterly (quarter ends). One of: annual, quarterly. |
limit | query | integer | no | 8 | Periods, newest first, 1 to 200. |
as_of | query | string | no | Point in time: each value as known from filings accepted by then. YYYY-MM-DDTHH:MM:SSZ in UTC (add up to 6 decimals for an exact time), or YYYY-MM-DD for the whole UTC day. |
Responses
| Status | Body | Description |
|---|---|---|
200 | SimpleStatement (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | Problem (application/problem+json) | Missing, invalid, or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
404 | Problem (application/problem+json) | Not found. |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a SimpleStatement object.
| Field | Type | Required | Description |
|---|---|---|---|
as_of | string | null | yes | |
basis | string | yes | How the accuracy numbers were measured. |
cik | string | yes | |
excluded | Excluded | yes | |
excluded_total | integer | yes | |
has_more | boolean | yes | True when periods older than the oldest one returned exist. |
limit | integer | yes | |
line_items | array of SimpleStatementLine | yes | The lines in the statement's fixed order. A line with no value in any period is left out. |
map | object | yes | |
period | string | yes | One of: annual, quarterly, ttm. |
statement | string | yes | One of: balance_sheet, income_statement, cash_flow. |
Example request
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/companies/AAPL/balance-sheet",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())Example answer
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/companies/AAPL/balance-sheet",
params={"period": "annual", "limit": "2"},
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json()){
"as_of": null,
"basis": "per field, its set: holdout-5 (the core 15), holdout-6 (the full template's further fields) or holdout-7 (sga, selling_marketing, general_administrative under map full-1.1.0), 300 company-year cells each never used to write the rules, values checked against SEC's R pages; precision = correct / serve…(truncated)",
"cik": "0000320193",
"excluded": [],
"excluded_total": 0,
"has_more": true,
"limit": 2,
"line_items": [
{
"accuracy": {
"correct": 295,
"coverage_pct": 98.3,
"precision_pct": 100,
"served": 295,
"set": "holdout-5"
},
"concept": "cash_and_equivalents",
"label": "Cash and cash equivalents",
"unit": "iso4217:USD",
"values": [
{
"accession_number": "0000320193-26-000026",
"filing_date": "2026-11-03",
"fiscal_period": "FY",
"fiscal_year": 2026,
"form_type": "10-K",
"period_end": "2026-09-26",
"period_start": null,
"source": "reported",
"status": "ok",
"value": "36305000000"
},
{
"accession_number": "0000320193-26-000026",
"filing_date": "2026-11-03",
"fiscal_period": "FY",
"fiscal_year": 2025,
"form_type": "10-K",
"period_end": "2025-09-27",
"period_start": null,
"source": "reported",
"status": "ok",
"value": "35934000000"
}
]
},
{
"accuracy": {
"correct": 63,
"coverage_pct": 21,
"precision_pct": 100,
"served": 63,
"set": "holdout-6"
},
"concept": "short_term_investments",
"label": "Short-term investments",
"unit": "iso4217:USD",
"values": [
{
"accession_number": "0000320193-26-000026",
"filing_date": "2026-11-03",
"fiscal_period": "FY",
"fiscal_year": 2026,
"form_type": "10-K",
"period_end": "2026-09-26",
"period_start": null,
"source": "reported",
"status": "ok",
"value": "20417000000"
},
{
"accession_number": "0000320193-26-000026",
"filing_date": "2026-11-03",
"fiscal_period": "FY",
"fiscal_year": 2025,
"form_type": "10-K",
"period_end": "2025-09-27",
"period_start": null,
"source": "reported",
"status": "ok",
"value": "18763000000"
}
]
}
],
"map": {
"fingerprint": "ade632e382bf0a76c5b99dc3c7e693d0cb41378812323adf61b635f865680895",
"version": "full-1.1.0"
},
"period": "annual",
"statement": "balance_sheet",
"resolved": {
"cik": "0000320193",
"ticker": "AAPL",
"ticker_file_date": "2026-11-18"
}
}More in Financial data (XBRL)
Next: GET /v3/companies/{cik_or_ticker}/cash-flow
Markdown version: /docs/reference/get-companies-cik-or-ticker-balance-sheet.md