> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/statements/share-float

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

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

<Info>
  Audience: application and coding agent.
</Info>

## 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](/api-conventions) and [freshness and source evidence](/freshness-and-trust).

## 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.

## Related guides

<CardGroup cols={2}>
  <Card title="XBRL API guide" icon="braces" href="/seo/xbrl-api">Trace company-facts fields back to their SEC source context.</Card>
  <Card title="Coverage and depth" icon="layers" href="/coverage-and-depth">Understand when the available source data is partial or unavailable.</Card>
</CardGroup>

## Canonical metadata

* `requestId`
* `traceparent`
* `provenance`
* `freshness`
* `materialization`
* `capability`
* `sourceMode`

## Example request

<RequestExample>
  ```bash theme={null}
  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"
  ```
</RequestExample>

## Example response

<ResponseExample>
  ```json theme={null}
  {
    "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"
  }
  ```
</ResponseExample>

## 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

<Prompt>
  Use SEC API GET /v1/statements/share-float to retrieve an issuer's disclosed public float when available, with explicit shares-outstanding proxy semantics otherwise. Supply one issuer identifier and preserve `publicFloatUsd`, `sharesOutstanding`, `sourceMode`, `statusNote`, provenance, freshness, materialization, `requestId`, and `traceparent`. Never label a shares-outstanding proxy as public float.
</Prompt>

## 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