GET /v1/statements/share-float

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=EXAMPLE"

{
  "object": "share_float",
  "id": "share_float_ent_example",
  "createdAt": "2026-02-20T00:00:00.000Z",
  "livemode": false,
  "entityId": "ent_example",
  "ticker": "EXAMPLE",
  "cik": "0000000000",
  "companyName": "Example Issuer, Inc.",
  "asOf": "2026-02-20",
  "form": "10-K",
  "filingDate": "2026-02-20",
  "reportDate": "2025-12-31",
  "capability": "degraded",
  "sourceMode": "shares_outstanding_proxy",
  "statusNote": "The illustrative company-facts coverage exposes shares outstanding but not a same-surface public-float dollar fact, so this example returns the shares-outstanding proxy.",
  "publicFloatUsd": null,
  "sharesOutstanding": 123456789,
  "xbrlData": {
    "EntityCommonStockSharesOutstanding": 123456789
  },
  "facts": {
    "publicFloatUsd": null,
    "sharesOutstanding": {
      "taxonomy": "dei",
      "tag": "EntityCommonStockSharesOutstanding",
      "label": "Entity Common Stock, Shares Outstanding",
      "unit": "shares",
      "value": 123456789,
      "periodEnd": "2025-12-31",
      "filedAt": "2026-02-20",
      "form": "10-K"
    }
  },
  "summaryMd": "## Share float coverage for Example Issuer, Inc.\n\nThis illustrative response has 123,456,789 shares outstanding, but no same-surface public-float dollar fact, so it remains in degraded proxy mode.",
  "provenance": {
    "source": "example",
    "sourceLabel": "Illustrative response - not a live SEC filing",
    "accessionNumber": null,
    "filingUrl": "https://example.com/sec-filings/example-2025-10-k",
    "retrievedAt": "2026-02-20T00:00:00.000Z",
    "parserVersion": "example"
  },
  "freshness": {
    "status": "archival",
    "asOf": "2026-02-20T00:00:00.000Z",
    "sourcePublishedAt": "2026-02-20",
    "lagMs": 0
  },
  "materialization": {
    "parserVersion": "example",
    "materializationVersion": "example"
  },
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

Retrieve disclosed public float when SEC company-facts coverage provides it, otherwise an explicitly labeled shares-outstanding proxy with its source and status.

Audience: application and coding agent.

Coverage and source scope

Use this route when a workflow needs the public-float fact reported in SEC company facts and must distinguish it from a shares-outstanding proxy. Check sourceMode, statusNote, unit, reporting date, provenance, and freshness before using a value: publicFloatUsd may be null while sharesOutstanding is present. A proxy is not public float, market capitalization, or free float. See API conventions and freshness and source evidence.

Interpret the source mode

Supply one issuer identifier. publicFloatUsd is populated only when the relevant public-float fact is available on the SEC company-facts surface. When it is not, the response may provide sharesOutstanding with sourceMode=shares_outstanding_proxy; that proxy is a share count, not a public-float dollar value. Use statusNote, capability, sourceMode, provenance, freshness, and materialization to explain the result. Preserve null public float as unknown rather than substituting or estimating a dollar value.

XBRL API guide

Trace company-facts fields back to their SEC source context.

Coverage and depth

Understand when the available source data is partial or unavailable.

Canonical 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=EXAMPLE"

Example response

{
  "object": "share_float",
  "id": "share_float_ent_example",
  "createdAt": "2026-02-20T00:00:00.000Z",
  "livemode": false,
  "entityId": "ent_example",
  "ticker": "EXAMPLE",
  "cik": "0000000000",
  "companyName": "Example Issuer, Inc.",
  "asOf": "2026-02-20",
  "form": "10-K",
  "filingDate": "2026-02-20",
  "reportDate": "2025-12-31",
  "capability": "degraded",
  "sourceMode": "shares_outstanding_proxy",
  "statusNote": "The illustrative company-facts coverage exposes shares outstanding but not a same-surface public-float dollar fact, so this example returns the shares-outstanding proxy.",
  "publicFloatUsd": null,
  "sharesOutstanding": 123456789,
  "xbrlData": {
    "EntityCommonStockSharesOutstanding": 123456789
  },
  "facts": {
    "publicFloatUsd": null,
    "sharesOutstanding": {
      "taxonomy": "dei",
      "tag": "EntityCommonStockSharesOutstanding",
      "label": "Entity Common Stock, Shares Outstanding",
      "unit": "shares",
      "value": 123456789,
      "periodEnd": "2025-12-31",
      "filedAt": "2026-02-20",
      "form": "10-K"
    }
  },
  "summaryMd": "## Share float coverage for Example Issuer, Inc.\n\nThis illustrative response has 123,456,789 shares outstanding, but no same-surface public-float dollar fact, so it remains in degraded proxy mode.",
  "provenance": {
    "source": "example",
    "sourceLabel": "Illustrative response - not a live SEC filing",
    "accessionNumber": null,
    "filingUrl": "https://example.com/sec-filings/example-2025-10-k",
    "retrievedAt": "2026-02-20T00:00:00.000Z",
    "parserVersion": "example"
  },
  "freshness": {
    "status": "archival",
    "asOf": "2026-02-20T00:00:00.000Z",
    "sourcePublishedAt": "2026-02-20",
    "lagMs": 0
  },
  "materialization": {
    "parserVersion": "example",
    "materializationVersion": "example"
  },
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

About this example

This response is illustrative: EXAMPLE, all IDs, amounts, and example.com URLs are synthetic. It demonstrates the degraded shares-outstanding proxy when public float is unavailable and does not identify or claim a live SEC filing.

Give this prompt to your agent

Failure posture

provide one issuer identifier and preserve the returned sourceMode and statusNote
never relabel shares_outstanding_proxy as public float or estimate publicFloatUsd when it is null
preserve capability, provenance, freshness, materialization, requestId, and traceparent when handling a partial or transient result

GET /v1/statements/segmented-revenues Stocks

​Coverage and source scope

​Interpret the source mode

​Related guides

XBRL API guide

Coverage and depth

​Canonical metadata

​Example request

​Example response

​About this example

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Interpret the source mode

Related guides

Canonical metadata

Example request

Example response

About this example

Give this prompt to your agent

Failure posture