---
title: "Security reference data"
method: GET
path: "/v1/market/reference"
---

# Security reference data

`GET /v1/market/reference`

## Request

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

Use this route to normalize a known security symbol before joining it to SEC records, market history, or an issuer view. Supply `ticker` or its `symbol` alias. The response can include identifiers, listing fields, classification, and market-cap context when available; null fields are unavailable values, not inferred substitutes. Preserve the returned symbol, CIK, FIGIs, `asOf`, freshness, provenance, source-rights, and revision metadata. See [API conventions](https://docs.secapi.ai/api-conventions).

## Query parameters

- `ticker` string
- `symbol` string

## Response `200`

Successful response

- MarketReference
  - `object` 'market_reference', required
  - `id` string, required
  - `createdAt` string, required
  - `livemode` boolean, required
  - `symbol` string, required
  - `name` string, nullable
  - `market` string, nullable
  - `locale` string, nullable
  - `exchange` string, nullable
  - `securityType` string, nullable
  - `active` boolean, nullable
  - `currency` string, nullable
  - `cik` string, nullable
  - `compositeFigi` string, nullable
  - `shareClassFigi` string, nullable
  - `marketCap` number, nullable
  - `listDate` string, nullable
  - `homepageUrl` string, nullable
  - `description` string, nullable
  - `sicCode` string, nullable
  - `sicDescription` string, nullable
  - `totalEmployees` integer, nullable
  - `phoneNumber` string, nullable
  - `address` object
  - `branding` object
  - `asOf` string, required
  - `requestId` string, required
  - `traceparent` string, required
  - `provenance` object
    - `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` object
    - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
    - `asOf` string, required
    - `sourcePublishedAt` string, nullable
    - `lagMs` integer, nullable
  - `materialization` object
    - `parserVersion` string, required
    - `materializationVersion` string, required
  - `sourceRights` object
    - `source` string, required
    - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
    - `publicAvailability` string
    - `contractStatus` string
    - `restrictions` string[]
  - `revision` object
    - `sourcePublishedAt` string, nullable
    - `retrievedAt` string, required
    - `vintageId` string, nullable
    - `revisedFrom` string, nullable
  - `trace` object

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