---
title: "Search filing sections"
method: GET
path: "/v1/sections/search"
---

# Search filing sections

`GET /v1/sections/search`

## Request

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

Search filing sections and snippets with filing-scoped filters and cursor pagination.

## Query parameters

- `q` string
- `ticker` string
- `symbol` string
- `cik` string
- `form` string
- `filing_id` string
- `filing_year` integer
- `fy` integer
- `year` integer
- `fp` string
- `quarter` string
- `limit` integer
- `cursor` integer
- `view` 'default' | 'compact' | 'agent'

## Response `200`

Section search results with pagination and request tracing metadata.

- object
  - `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
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `queryPath` string, nullable
  - `queryPathReason` string, nullable
  - `policyYears` object, nullable
  - `degradedState` object, nullable
  - `responseMode` string
  - `include` string[]
  - `requestId` string, required
  - `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)