---
title: "Full-text filing search"
method: GET
path: "/v1/search/fulltext"
---

# Full-text filing search

`GET /v1/search/fulltext`

## Request

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

Full-text search across filing content and section text.

## Query parameters

- `q` string, required
- `ticker` string
- `symbol` string
- `cik` string
- `form` string
- `accession_number` string
- `filing_year` integer
- `fy` integer
- `year` integer
- `date_from` string, date
- `date_to` string, date
- `limit` integer

## Response `200`

Full-text filing and section search results with request tracing metadata.

- object
  - `object` 'fulltext_search', required
  - `query` string, required
  - `filings` object, required
    - `object` 'list', required
    - `data` Filing[], required
      - `object` 'filing', required
      - `id` string, required
      - `createdAt` string, required
      - `livemode` boolean, required
      - `entityId` string, required
      - `ticker` string, nullable
      - `companyName` string
      - `form` string, required
      - `filingDate` string, required
      - `reportDate` string, nullable
      - `accessionNumber` string, required
      - `title` string, required
      - `summaryMd` string
      - `snippet` string
      - `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[]
    - `count` integer, required
  - `sections` object, required
    - `object` 'list', required
    - `data` object[], required
      - `object` 'section', required
      - `id` string, required
      - `ticker` string, nullable
      - `form` string
      - `key` string, required
      - `title` string, required
      - `contentMd` string, required
      - `snippet` string
      - `accession` string, nullable, required
      - `section_key` string, nullable, required
      - `char_start` integer, nullable, required
      - `char_end` integer, nullable, required
      - `highlighted_snippet` string, nullable, required
      - `source_url` string, uri, nullable, required
      - `score` number, nullable
      - `retrievalMode` 'keyword' | 'semantic' | 'hybrid'
      - `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
    - `count` integer, required
    - `degradedState` object, nullable, required
  - `requestId` string, required
  - `traceparent` string, required

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