HTTP Endpoint Reference¶
Generated from the FastAPI OpenAPI schema (disclosure_alpha.api.app_factory).
Regenerate with:
python scripts/generate_http_endpoints_docs.py
Conceptual guide: HTTP API Guide. Interactive docs: HTTP API (OpenAPI).
Common errors¶
Code |
When |
|---|---|
404 |
Filing not found for ticker / year / form |
422 |
Invalid query or body (e.g. panel with >25 tickers) |
502 |
Upstream EDGAR fetch failure |
GET /health¶
Health
Response (200): object
Responses¶
Status |
Description |
|---|---|
200 |
Successful Response |
Example¶
curl "http://localhost:8000/health"
GET /v1/company/{ticker}/disclosure-changes¶
Disclosure Changes
Parameters¶
Name |
In |
Required |
Type |
Description |
|---|---|---|---|---|
|
path |
yes |
string |
|
|
query |
yes |
integer |
|
|
query |
no |
string |
|
|
query |
no |
object |
|
|
query |
no |
string |
|
|
query |
no |
object |
Response (200): ChangesResponse
Responses¶
Status |
Description |
|---|---|
200 |
Successful Response |
404 |
Not Found |
422 |
Unprocessable Entity |
502 |
Bad Gateway |
Example¶
curl "http://localhost:8000/v1/company/AAPL/disclosure-changes?fiscal_year=2025&form_type=10-K"
GET /v1/company/{ticker}/disclosure-flags¶
Disclosure Flags
Parameters¶
Name |
In |
Required |
Type |
Description |
|---|---|---|---|---|
|
path |
yes |
string |
|
|
query |
yes |
integer |
|
|
query |
no |
string |
|
|
query |
no |
object |
|
|
query |
no |
string |
|
|
query |
no |
object |
Response (200): FlagsResponse
Responses¶
Status |
Description |
|---|---|
200 |
Successful Response |
404 |
Not Found |
422 |
Unprocessable Entity |
502 |
Bad Gateway |
Example¶
curl "http://localhost:8000/v1/company/AAPL/disclosure-flags?fiscal_year=2025&form_type=10-K"
GET /v1/company/{ticker}/disclosure-matrix¶
Disclosure Matrix
Parameters¶
Name |
In |
Required |
Type |
Description |
|---|---|---|---|---|
|
path |
yes |
string |
|
|
query |
yes |
integer |
|
|
query |
no |
string |
|
|
query |
no |
object |
|
|
query |
no |
string |
|
|
query |
no |
object |
|
|
query |
no |
object |
|
|
query |
no |
object |
|
|
query |
no |
object |
Response tier preset (lite|standard|analyst); overrides include/fields when set |
|
query |
no |
string |
Scoring model: deterministic_scoring_v2 (default) or deterministic_scoring_v1 |
Response (200): MatrixResponse
Responses¶
Status |
Description |
|---|---|
200 |
Successful Response |
404 |
Not Found |
422 |
Unprocessable Entity |
502 |
Bad Gateway |
Example¶
curl "http://localhost:8000/v1/company/AAPL/disclosure-matrix?fiscal_year=2025&form_type=10-K"
GET /v1/company/{ticker}/disclosure-metrics¶
Disclosure Metrics
Parameters¶
Name |
In |
Required |
Type |
Description |
|---|---|---|---|---|
|
path |
yes |
string |
|
|
query |
yes |
integer |
|
|
query |
no |
string |
|
|
query |
no |
object |
|
|
query |
no |
string |
|
|
query |
no |
object |
Response (200): MetricsResponse
Responses¶
Status |
Description |
|---|---|
200 |
Successful Response |
404 |
Not Found |
422 |
Unprocessable Entity |
502 |
Bad Gateway |
Example¶
curl "http://localhost:8000/v1/company/AAPL/disclosure-metrics?fiscal_year=2025&form_type=10-K"
GET /v1/company/{ticker}/filings¶
Company Filings
Parameters¶
Name |
In |
Required |
Type |
Description |
|---|---|---|---|---|
|
path |
yes |
string |
|
|
query |
yes |
integer |
|
|
query |
no |
object |
Response (200): FilingsResponse
Responses¶
Status |
Description |
|---|---|
200 |
Successful Response |
404 |
Not Found |
422 |
Validation Error |
502 |
Bad Gateway |
Example¶
curl "http://localhost:8000/v1/company/AAPL/filings?fiscal_year=2025&form_type=10-K"
GET /v1/company/{ticker}/sections¶
Company Sections
Parameters¶
Name |
In |
Required |
Type |
Description |
|---|---|---|---|---|
|
path |
yes |
string |
|
|
query |
yes |
integer |
|
|
query |
no |
string |
|
|
query |
no |
object |
|
|
query |
no |
string |
|
|
query |
no |
object |
|
|
query |
no |
boolean |
Response (200): SectionsResponse
Responses¶
Status |
Description |
|---|---|
200 |
Successful Response |
404 |
Not Found |
422 |
Unprocessable Entity |
502 |
Bad Gateway |
Example¶
curl "http://localhost:8000/v1/company/AAPL/sections?fiscal_year=2025&form_type=10-K"
POST /v1/panel/disclosure-matrix¶
Panel Disclosure Matrix
Request body: PanelRequest
Response (200): PanelResponse
Responses¶
Status |
Description |
|---|---|
200 |
Successful Response |
422 |
Unprocessable Entity |
Example¶
curl -s -X POST "http://localhost:8000/v1/panel/disclosure-matrix" \
-H "Content-Type: application/json" \
-d '{"tickers": ["AAPL", "MSFT"], "fiscal_year": 2025, "form_type": "10-K"}'