US Filing

GET /us/filings/{accession_number}

Call GET /us/filings/{accession_number} on the Corpus API.

Category: US · SEC Filings

Authentication

Send the provisioned API key in the X-API-KEY header.

Required scopes: us:read.

Request

Name	In	Required	Type	Constraints	Description
accession_number	path	yes	string	—	—

Example request

curl --request GET \
  --url 'https://corpus-api.onera.app/us/filings/0000320193-25-000079' \
  --header "X-API-KEY: ${CORPUS_API_KEY}"

Responses

Status	Description	Content type	Schema
200	Successful Response	application/json	USFilingResponse
400	Invalid parameter combination	application/json	ErrorResponse
401	Missing or invalid API key	application/json	ErrorResponse
403	Insufficient jurisdiction or scope	application/json	ErrorResponse
404	Unknown resource	application/json	ErrorResponse
422	Request schema validation failed	application/json	ErrorResponse
429	Rate limit exceeded	application/json	ErrorResponse
503	Source content is unavailable or still processing	application/json	FilingProcessingErrorResponse

Representative 200 response

{
  "filing": {
    "cik": "0000320193",
    "accession_number": "0000320193-25-000079",
    "filing_type": "10-K",
    "report_date": "2025-12-31",
    "filing_date": "2025-12-31",
    "filing_datetime": "2025-12-31T23:59:59Z",
    "ticker": "AAPL",
    "url": "https://corpus-api.onera.app",
    "is_xbrl": true,
    "content_status": "pending"
  }
}