> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altss.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Full-text search of issuer filings

> Up to ten matches from the SEC full-text index for one issuer, including the filed document link and published description when available.

Up to ten matches from the SEC full-text index for one issuer, including the filed document link and published description when available.

**Operation ID:** `filing.full_text_search`. **Family:** [Financial Intelligence](https://docs.altss.com/console/families/financial-intelligence.md).

[Read the live operation contract (JSON)](https://console.altss.com/v1/console/capabilities/filing.full_text_search) for the current input and output schemas, price, limits and required scopes.

**Status:** Available (`AVAILABLE`). **Supported interfaces:** REST, MCP.

**Commercial status:** Available. Receive the structured result and receipt in Console after the run settles.

**Execution interfaces:** UI, REST, MCP.

## When to use it

Search the text indexed by the SEC for one issuer’s annual or quarterly filings. Open the original document to read a match in context.

## Price and billing unit

Request a quote for one full-text search of issuer filings. Review its inputs, delivery plan, use terms and maximum charge before accepting. Retrying the same purchase uses the same idempotency key.

**Price:** \$0.05. **Billing unit:** per successful delivery.

**Charge condition:** The authorized execution delivers a validated result and settles once. Failed pre-settlement executions are not charged; reservation release must be confirmed. Retrieve the same run if charge state is uncertain.

**Execution budget:** Maximum \$0.05 per accepted execution.

Fund your Console wallet, review the quote and approve the charge before execution.

## Inputs

Issuer CIK, term, 10-K or 10-Q and filing dates

```json theme={null}
{
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "pattern": "^\\d{10}$"
    },
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "pattern": "^[A-Za-z0-9][A-Za-z0-9 &.'-]+$"
    },
    "form": {
      "type": "string",
      "enum": [
        "10-K",
        "10-Q"
      ]
    },
    "fromDate": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "toDate": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    }
  },
  "required": [
    "cik",
    "query",
    "form",
    "fromDate",
    "toDate"
  ],
  "additionalProperties": false
}
```

## Result and output schema

Up to ten matches from the SEC full-text index for one issuer, including the filed document link and published description when available.

```json theme={null}
{
  "$ref": "https://console.altss.com/openapi.json#/components/schemas/Result_filing_full_text_search"
}
```

## Examples

Illustrative request and result for this scope. The names, values and record references are examples. Actual delivery depends on the published availability and agreed scope.

### Example input

```json theme={null}
{
  "cik": "0000320193",
  "query": "revenue",
  "form": "10-K",
  "fromDate": "2025-01-01",
  "toDate": "2025-12-31"
}
```

### Example structured output

```json theme={null}
{
  "kind": "SEC_ISSUER_FULL_TEXT_SEARCH",
  "deliveredRecords": 2,
  "exampleDocument": {
    "issuerCik": "0000320193",
    "issuer": "Apple Inc.  (AAPL)  (CIK 0000320193)",
    "filedAt": "2025-10-31",
    "accession": "0000320193-25-000079",
    "document": "aapl-20250927.htm",
    "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
    "reportForm": "10-K",
    "documentType": "10-K",
    "filedDescription": "10-K"
  }
}
```

## API example and execution

[Verified production contract](https://console.altss.com/openapi.json) · Base URL: `https://console.altss.com/v1/console`. Quote first. Obtain explicit approval of the price, plan and use terms before sending accept:true. Reuse the same purchase idempotency key on retries.

Required scope: `company.read`. Organization authority, funding checks and spending limits apply to paid execution.

Supply credentials in the documented authorization header. Replace a placeholder run ID with an actual authorized run ID.

```json theme={null}
{
  "method": "POST",
  "url": "https://console.altss.com/v1/console/quote",
  "body": {
    "toolId": "filing.full_text_search",
    "input": {
      "cik": "0000320193",
      "query": "revenue",
      "form": "10-K",
      "fromDate": "2025-01-01",
      "toDate": "2025-12-31"
    }
  }
}
```

This example requests a quote. A paid run requires the unchanged returned quote, explicit acceptance and a stable idempotency key.

## MCP and A2A

**Supported interfaces:** REST, MCP. Current MCP tools: `altss_quote`, `altss_run`, `altss_get_run`. Inspect tools/list and inputSchema before use. Paid A2A execution is unavailable. The separate anonymous A2A reader serves public information.

[REST guide](https://docs.altss.com/console/rest.md) · [MCP guide](https://docs.altss.com/console/mcp.md) · [A2A scope](https://docs.altss.com/console/a2a.md) · [Authentication and credentials](https://docs.altss.com/console/authentication.md)

## Sources, evidence and freshness

* Public records and official sources

Retain source attribution, observation and event dates, evidence and explicit unknowns where supplied. A record update is not independent verification.

Historical source collection dates describe when the material was observed. Coverage and freshness depend on each returned source. Preserve its observation date and use restrictions with the result.

## Limits and permitted use

* Includes: Find documents in an issuer’s annual or quarterly filings that match a search term. Each hit links to the filed document and includes its SEC description when available.; Original filing citations. Excludes: Raw filings; Contact information; Investment advice. Requires scope company.read. Source: public registry.
* A timeout does not establish the final charge. Retrieve the existing run before retrying.

Use is limited by the accepted quote or agreed delivery scope, source restrictions and privacy controls. Storage, attribution, retention, redistribution and training permissions do not expand through normalization.

## Next step

[Try Console](https://console.altss.com/signup?src=buyer-intent\&cta=capability\&capability=filing.full_text_search) · [Open Console workspace](https://console.altss.com/console/playground/new?capability=filing.full_text_search) · [View the capability on Altss](https://altss.com/console/capabilities/filing.full_text_search) · [Wallet and billing](https://docs.altss.com/console/billing.md)

[Back to Financial Intelligence](https://docs.altss.com/console/families/financial-intelligence.md) · [All capabilities](https://docs.altss.com/console/capabilities.md) · [Price schedule](https://docs.altss.com/console/prices.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.