Skip to content
EndpointsFilings and activity

Stock Filings

SEC filing inventory with accessions, forms, dates, and source documents.

Playground keys are masked and used only for this browser-initiated test. The docs proxy forwards X-API-Key to POST /v1/tools/* and does not store it server-side. Fumadocs may keep the auth value in browser localStorage while this endpoint page is open; StockContext clears it when you leave or unload the page.

POST
/v1/tools/stock_filings

Serve SEC filing inventory.

Authorization

ApiKeyAuth
X-API-Key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request for stock_filings.

Response Body

application/json

application/json

curl -X POST "https://api.stockcontext.com/v1/tools/stock_filings" \  -H "X-API-Key: $STOCKCONTEXT_API_KEY" \  -H "Content-Type: application/json" \  -d '{"symbol":"AAPL","form":"10-K"}'
{
  "subject": {
    "entity": {
      "cik": "0000320193",
      "name": "Apple Inc."
    },
    "security": {
      "security_id": "sec_aapl_common",
      "ticker": "AAPL",
      "exchange": null
    }
  },
  "data": {
    "operation": "inventory",
    "filings": [
      {
        "accession": "0000320193-25-000079",
        "form": "10-K",
        "filed": "2025-10-31",
        "source_url": "https://www.sec.gov/Archives/edgar/data/320193/0000320193-25-000079.txt",
        "state": "VERIFIED",
        "period_end": "2025-09-27",
        "period_kind": "annual",
        "source_hash": "sha256:60f22bb90bb8e46894019fd57c27df69abd192f3f0f4183c4345d786426f3391",
        "observed_at": "2026-06-24T22:47:52.684685Z",
        "items": [],
        "full_text_submission": {
          "url": "https://www.sec.gov/Archives/edgar/data/320193/0000320193-25-000079.txt",
          "sha256": "sha256:60f22bb90bb8e46894019fd57c27df69abd192f3f0f4183c4345d786426f3391",
          "byte_size": 9392337,
          "observed_at": "2026-06-24T22:47:52.684685Z"
        }
      }
    ]
  },
  "meta": {
    "schema_version": "1",
    "as_of": {
      "sec": "2025-10-31"
    }
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}