---
title: "Public float"
method: GET
path: "/v1/statements/share-float"
---

# Public float

`GET /v1/statements/share-float`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/statements/share-float`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

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

## Query parameters

- `ticker` string
- `symbol` string
- `cik` string

## Response `200`

Successful response

- ShareFloat
  - `object` 'share_float', required
  - `id` string, required
  - `createdAt` string, required
  - `livemode` boolean, required
  - `entityId` string, required
  - `ticker` string, nullable, required
  - `cik` string, nullable, required
  - `companyName` string, required
  - `asOf` string, required
  - `form` string, nullable, required
  - `filingDate` string, nullable, required
  - `reportDate` string, nullable, required
  - `capability` object, required
  - `sourceMode` 'company_facts' | 'shares_outstanding_proxy' | 'not_disclosed' | 'unavailable', required
  - `statusNote` string, nullable, required
  - `publicFloatUsd` number, nullable, required
  - `sharesOutstanding` number, nullable, required
  - `xbrlData` object, required
  - `facts` object, required
    - `publicFloatUsd` ShareFloatFact, required
      - `taxonomy` string, required
      - `tag` string, required
      - `label` string, required
      - `unit` string, required
      - `value` number, required
      - `periodEnd` string, required
      - `filedAt` string, nullable, required
      - `form` string, nullable, required
    - `sharesOutstanding` ShareFloatFact, required
      - `taxonomy` string, required
      - `tag` string, required
      - `label` string, required
      - `unit` string, required
      - `value` number, required
      - `periodEnd` string, required
      - `filedAt` string, nullable, required
      - `form` string, nullable, required
  - `summaryMd` string, required
  - `provenance` ResponseMetadata, required
    - `source` string, required
    - `sourceLabel` string
    - `sourceAgency` string
    - `canonicality` string
    - `fallbackPolicy` string
    - `accessionNumber` string, nullable, required
    - `filingUrl` string, uri, required
    - `acceptedAt` string, nullable
    - `retrievedAt` string, required
    - `parserVersion` string, required
  - `freshness` FreshnessMetadata: Freshness of the record. For SEC filings, freshness measures the delay between SEC acceptance (`sourcePublishedAt`) and when the record became available in the API — not the age of the document. Statuses: `current` (recently published and available promptly), `archival` (an immutable historical document held in full; its availability delay is not a freshness signal), `degraded`/`stale` (a recently published filing that became available later than the freshness thresholds allow), `fresh` (continuously refreshed datasets recently observed at source), `unknown` (no timestamps). An old immutable filing is never `stale` simply because it was published long ago. `lagMs` is the publish-to-availability delay in milliseconds.
    - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
    - `asOf` string, required
    - `sourcePublishedAt` string, nullable
    - `lagMs` integer, nullable
  - `materialization` MaterializationMetadata
    - `parserVersion` string, required
    - `materializationVersion` string, required
  - `validation` ValidationStatus
    - `status` 'validated' | 'unvalidated' | 'degraded', required
    - `confidence` 'high' | 'medium' | 'low', nullable
    - `validatedAt` string, nullable
    - `validationPipeline` string, nullable
    - `exceptions` string[]
  - `requestId` string
  - `traceparent` string

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)