Filing Sections
Extract selected qualitative filing sections and optional embedded tables.
Tier: public | Cache: cold-allowed | Playground: authenticated only | Contract: 1.1.0
When To Use It
Use these tools to discover filings, inspect filing artifacts, and retrieve source-backed document evidence.
Request Examples
BASE_URL="${EDGAR_API_URL:-https://www.edgarparser.com}"
curl -sS -G "$BASE_URL/api/sections" \
-H "Authorization: Bearer $EDGAR_API_KEY" \
--data-urlencode "ticker=AAPL" \
--data-urlencode "year=2025" \
--data-urlencode "quarter=4" \
--data-urlencode "sections=Item 7"import os
import requests
base_url = os.getenv("EDGAR_API_URL", "https://www.edgarparser.com")
headers = {"Authorization": f"Bearer {os.environ['EDGAR_API_KEY']}"}
params = {
"ticker": "AAPL",
"year": 2025,
"quarter": 4,
"sections": "Item 7"
}
response = requests.get(f"{base_url}/api/sections", headers=headers, params=params, timeout=30)
response.raise_for_status()
data = response.json()Key Response Fields
| Field | Type | Why It Matters |
|---|---|---|
status | const "success" | Transport-level success indicator inside the JSON response. |
semantic_status | "ok" | "partial" | "empty" | "error" | null | Whether the response is semantically usable, partial, empty, or errored. |
coverage_status | "complete" | "partial" | "narrow" | "none" | null | Completeness signal; do not present partial or narrow coverage as complete. |
coverage_warning | string | null | Human-readable explanation of missing or ambiguous coverage. |
sections | object | null | Filing sections returned or matched by the request. |
declared_sections | array<string> | null | Filing metadata or document field; verify accession and section context before citing it. |
filing | object | null | Filing metadata or document field; verify accession and section context before citing it. |
filing_type | string | null | Filing metadata or document field; verify accession and section context before citing it. |
Response Fields To Inspect
accession,filing_url, form type, and period fields to confirm the filing identity.- Pagination or truncation fields before assuming the returned text is complete.
- Section titles and document names when citing prose back to the filing.
Errors And Coverage
401or403: the API key is missing, expired, or not allowed to use this tier.429: retry after the rate-limit window, and prefer broader batch or series tools over repeated single-period calls.- Cold work can take longer and may queue background fetch or parse work; use status fields or follow-up tools before finalizing.
- Honor pagination and truncation metadata; request the next page instead of assuming the first response is complete.
Related Tools
Filing Document, Filing Tables, Search Filing Text
Generated Reference
Contract
| Field | Value |
|---|---|
| Tool | get_filing_sections |
| Method | GET |
| Path | /api/sections |
| Contract version | 1.1.0 |
Parameters
| Name | Location | Required | Type | Notes |
|---|---|---|---|---|
ticker | query | no | string | null | |
year | query | no | integer | null | |
quarter | query | no | integer | null | |
sections | query | no | string | null | |
source | query | no | string | null | |
accession | query | no | string | null | |
cik | query | no | string | null | |
form_type | query | no | string | null | |
primary_document | query | no | string | null | |
format | query | no | string | |
max_words | query | no | string | |
include_tables | query | no | boolean | |
fallback | query | no | boolean |
Response Schema (200)
{
"additionalProperties": true,
"properties": {
"coverage_status": {
"anyOf": [
{
"enum": [
"complete",
"partial",
"narrow",
"none"
],
"type": "string"
},
{
"type": "null"
}
]
},
"coverage_warning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"declared_sections": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"filing": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"accession": {
"anyOf": [
{
"pattern": "^\\d{10}-\\d{2}-\\d{6}$",
"type": "string"
},
{
"type": "null"
}
]
},
"cik": {
"anyOf": [
{
"pattern": "^\\d{1,10}$",
"type": "string"
},
{
"type": "null"
}
]
},
"document_url": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"filing_date": {
"anyOf": [
{
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
{
"type": "null"
}
]
},
"filing_url": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"fiscal_quarter": {
"anyOf": [
{
"maximum": 4.0,
"minimum": 1.0,
"type": "integer"
},
{
"type": "null"
}
]
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"form": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"form_type": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
{
"type": "null"
}
]
},
"primary_document": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"primary_document_url": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"report_date": {
"anyOf": [
{
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"filing_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"parser_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"parser_schema_version": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"parser_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"producer_build_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"producer_deployment_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"producer_instance_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"result_message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"result_status": {
"anyOf": [
{
"enum": [
"ok",
"all_missing",
"partial"
],
"type": "string"
},
{
"type": "null"
}
]
},
"sections": {
"anyOf": [
{
"additionalProperties": {
"additionalProperties": true,
"properties": {
"cross_reference_target": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"declaration_type": {
"anyOf": [
{
"const": "no_change",
"type": "string"
},
{
"type": "null"
}
]
},
"header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"enum": [
"body",
"cross_reference",
"absent",
"missing"
],
"type": "string"
},
{
"type": "null"
}
]
},
"tables": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"word_count": {
"anyOf": [
{
"minimum": 0.0,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"type": "object"
},
"type": "object"
},
{
"type": "null"
}
]
},
"sections_absent": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"sections_by_declaration_type": {
"anyOf": [
{
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "object"
},
{
"type": "null"
}
]
},
"sections_by_state": {
"anyOf": [
{
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "object"
},
{
"type": "null"
}
]
},
"sections_found": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"sections_missing": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"sections_unavailable": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"semantic_status": {
"anyOf": [
{
"enum": [
"ok",
"partial",
"empty",
"error"
],
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"const": "success",
"type": "string"
},
"toc_confidence": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"toc_detection_method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"toc_table_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"status"
],
"type": "object"
}