Skip to main content

​
GET /v1/statements/share-float

Return a share-float wrapper backed by SEC company facts, including disclosed public float when available and shares-outstanding fallback semantics otherwise
Use this endpoint from server-side applications, SDKs, or agent workflows.

​
Response metadata

  • requestId
  • traceparent
  • provenance
  • freshness
  • materialization
  • capability
  • sourceMode

​
Example request

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/statements/share-float?ticker=MSFT"

​
Example response

{
  "object": "share_float",
  "id": "share_float_ent_msft",
  "createdAt": "2026-03-18T16:00:00.000Z",
  "livemode": false,
  "entityId": "ent_msft",
  "ticker": "MSFT",
  "cik": "0000789019",
  "companyName": "Microsoft Corporation",
  "asOf": "2026-01-28",
  "form": "10-Q",
  "filingDate": "2026-01-28",
  "reportDate": "2025-12-31",
  "capability": "degraded",
  "sourceMode": "shares_outstanding_proxy",
  "statusNote": "The latest SEC company-facts coverage exposes shares outstanding but not a same-API public-float dollar fact, so SEC API is returning the shares-outstanding proxy.",
  "publicFloatUsd": null,
  "sharesOutstanding": 7433000000,
  "xbrlData": {
    "EntityCommonStockSharesOutstanding": 7433000000
  },
  "facts": {
    "publicFloatUsd": null,
    "sharesOutstanding": {
      "taxonomy": "dei",
      "tag": "EntityCommonStockSharesOutstanding",
      "label": "Entity Common Stock, Shares Outstanding",
      "unit": "shares",
      "value": 7433000000,
      "periodEnd": "2025-12-31",
      "filedAt": "2026-01-28",
      "form": "10-Q"
    }
  },
  "summaryMd": "## Share float coverage for Microsoft Corporation\n\nSEC API found 7,433,000,000 shares outstanding, but the issuer does not expose a same-API public-float dollar fact in the latest company-facts coverage, so this response stays in degraded proxy mode.",
  "provenance": {
    "source": "sec",
    "accessionNumber": null,
    "filingUrl": "https://www.sec.gov/edgar/searchedgar/companysearch",
    "retrievedAt": "2026-03-18T16:00:00.000Z",
    "parserVersion": "2026-03-18.1"
  },
  "freshness": {
    "status": "fresh",
    "asOf": "2026-03-18T16:00:00.000Z",
    "sourcePublishedAt": "2026-01-28",
    "lagMs": 0
  },
  "materialization": {
    "parserVersion": "2026-03-18.1",
    "materializationVersion": "2026-03-18.1"
  },
  "requestId": "req_example_123",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

​
Give this prompt to your agent

Copy this SEC API prompt for your agent.

​
Errors and partial results

  • Treat non-2xx responses as API errors and log the response body for debugging
  • Log requestId and traceparent so SEC API support can trace the request
  • if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff