---
title: "Full-text search across filing exhibits"
method: GET
path: "/edgar/search-text"
tags: ["EDGAR"]
---

# Full-text search across filing exhibits

`GET /edgar/search-text`

## Request

- Base URL: `https://api.signal8.ai/api/v1/public`
- URL: `https://api.signal8.ai/api/v1/public/edgar/search-text`
- Auth: API key in header `X-Api-Key`

Full-text search across SEC EDGAR filing content, websearch syntax
("quoted phrase", OR, -exclude), one match per filing, newest first or
ranked (`sort=relevance`). Quote a multi-word phrase — unquoted words
match anywhere in the filing. A request scoped to a CIK / filing /
accession whose text is not yet indexed is answered by a bounded
substring scan instead (`engine: substring`, pattern matched literally).
Returns matching snippets with surrounding context for each hit —
useful for locating specific clauses like "right of first refusal" or
"change of control". Optionally narrow by company (CIK), filing,
accession number, or form type.

**Credit cost: 5**

## Query parameters

- `pattern` string, required
- `understand` boolean
- `facets` boolean
- `section` string
- `exhibitTypes` string
- `matchedSections` boolean
- `cik` string
- `filingId` string
- `accessionNumber` string
- `formType` string
- `limit` integer
- `snippetLength` integer
- `sort` string
- `match` string

## Response `200`

Matching snippets with context. `meta` (engine, applied
`matchMode`, `matchModeFallbackReason`) is added when the archive
states it; otherwise the body is `{ data }` as before. With
`section`, `meta.sections` confirms the restriction or
`meta.unsupported` says why it was not applied; matches may carry
`matchedSections` (absent ⇒ not measured). Matches carry no
exhibit list, so `exhibitTypes` is reported applied only on
evidence that the archive supports it (else `meta.unsupported`
`not-verified`).

- object

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid API key
- `402`: Not enough credits for this request
- `429`: Rate limit exceeded

---

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