> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentkey.app/llms.txt > Use this file to discover all available pages before exploring further. # finance.filings.search > Search SEC EDGAR filings by ticker / CIK, form type, date window or full text. Returns a normalized Filing page, most recent first. ## OpenAPI ````yaml api-reference/openapi/v2.yaml POST /v2/ops/finance.filings.search openapi: 3.1.0 info: description: >- Fixed, versioned, provider-independent methods over AgentKey's upstream catalog. Each method has a stable name, input schema and output schema; the server picks the upstream provider, fails over, normalizes fields and refunds failed attempts. Every response names the provider that served it, the credits charged and every attempt made. title: AgentKey Scenario Methods version: '2' servers: - url: https://api.agentkey.app security: [] paths: /v2/ops/finance.filings.search: post: tags: - finance summary: >- Search SEC EDGAR filings by ticker / CIK, form type, date window or full text. Returns a normalized Filing page, most recent first. description: >- Give a symbol or cik (optionally form_type, start, end) to list a company's filings, or a query to full-text search every filing since 2001 (combine with cik, form_type, start, end). Results are normalized to Filing; text and sections stay null here — fetch one document with finance.filings.get. Fixed price: 0.1 credits per successful call, whichever provider serves it. operationId: finance_filings_search requestBody: content: application/json: schema: additionalProperties: false properties: cik: description: Filer CIK, with or without zero padding (320193). type: string cursor: description: >- Opaque pagination cursor from the previous response's next_cursor. Send the same query parameters with it. type: string end: description: Latest filing date, YYYY-MM-DD. format: date type: string fields: $ref: '#/components/schemas/FieldsProjection' form_type: description: >- Form type, exact and uppercase: 10-K, 10-Q, 8-K, 4, DEF 14A, S-1. type: string include_raw: $ref: '#/components/schemas/IncludeRaw' limit: default: 20 description: Maximum number of filings to return. maximum: 50 minimum: 1 type: integer provider: $ref: '#/components/schemas/ProviderShorthand' query: description: >- Full-text search phrase (climate risk, "supply chain" AND China). Routes to the SEC full-text engine; combine with cik rather than symbol. type: string routing: $ref: '#/components/schemas/Routing' start: description: Earliest filing date, YYYY-MM-DD. format: date type: string symbol: description: Filer ticker (AAPL). type: string type: object required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/FilingPageEnvelope' description: Success envelope '400': $ref: '#/components/responses/ValidationError' '402': $ref: '#/components/responses/InsufficientCredits' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '502': $ref: '#/components/responses/UpstreamFailed' '504': $ref: '#/components/responses/Timeout' security: - ApiKeyAuth: [] components: schemas: FieldsProjection: description: >- Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"]. items: type: string type: array IncludeRaw: default: false description: >- Attach the raw upstream payload as `raw` (not a stable contract; truncated above 256 KB). type: boolean ProviderShorthand: description: Shorthand for routing.only = [provider]. type: string Routing: additionalProperties: false description: >- Provider routing override. order: try these providers first; only: restrict to these (equivalent to pinning); allow_fallbacks: false tries only the first eligible provider. properties: allow_fallbacks: default: true description: false = try only the first eligible provider. type: boolean only: description: Restrict to these providers. items: type: string type: array order: description: Providers to try first, in order. items: type: string type: array strategy: default: auto description: >- How eligible providers are ordered. auto = the method's curated order. fastest / stable / popular are specified but not implemented yet (400 until then). The price is fixed whatever the strategy; mutually exclusive with order. enum: - auto type: string type: object FilingPageEnvelope: allOf: - $ref: '#/components/schemas/Envelope' - properties: data: $ref: '#/components/schemas/FilingPage' type: object description: Success envelope whose data is a FilingPage. Envelope: description: Success envelope. `data` is the method's output object. properties: attempts: items: $ref: '#/components/schemas/Attempt' type: array credits_charged: description: Credits charged for this call (the method's fixed price). type: number data: description: Method output (typed per method). op: description: Method name. type: string op_version: description: Method version that served the call. type: integer provider: description: Provider that actually served the call. type: string raw: description: Upstream payload, only with include_raw=true. Not a stable contract. raw_truncated: type: boolean request_id: description: Correlation id; quote it in support requests. type: string took_ms: type: integer unsupported_fields: description: >- Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'. items: type: string type: array required: - op - op_version - provider - request_id - credits_charged - took_ms - attempts - unsupported_fields - data type: object FilingPage: additionalProperties: false description: One page of filings, most recent first. properties: items: items: $ref: '#/components/schemas/Filing' type: array next_cursor: description: >- Opaque cursor for the next page; null when exhausted or the provider cannot page. type: - string - 'null' required: - items - next_cursor type: object ErrorEnvelope: properties: attempts: items: $ref: '#/components/schemas/Attempt' type: array code: type: integer error: description: Human-readable message. type: string error_type: description: >- validation | not_found | rate_limit | timeout | insufficient_credits | upstream_unauthorized | upstream_unavailable | provider_error type: string op: description: Method name. type: string request_id: description: Correlation id. type: string required: - error - code - error_type type: object Attempt: description: >- One upstream try. Present on success and failure so a failover is never invisible. properties: error_type: description: >- validation | not_found | rate_limit | timeout | upstream_unauthorized | upstream_unavailable | provider_error type: string provider: description: Provider slug. type: string refunded: description: true when the reservation for this attempt was refunded. type: boolean status: description: HTTP status AgentKey mapped this attempt to (200 on success). type: integer took_ms: type: integer tool: description: Registry tool name (Provider/operation) that was called. type: string upstream_status: description: The provider's real HTTP status; absent when nothing was received. type: integer required: - provider - tool - status - took_ms type: object Filing: additionalProperties: false description: >- A regulatory filing (SEC EDGAR). Search methods fill the metadata; finance.filings.get fills text / sections for one document. properties: cik: description: Filer CIK, zero-padded to 10 digits when the vendor pads it. type: - string - 'null' company: description: Filer name. type: - string - 'null' description: description: Filing description / document title. type: - string - 'null' filed_at: description: >- Filing acceptance time, RFC 3339 UTC (date-only vendors give midnight UTC). format: date-time type: - string - 'null' form_type: description: Form type (10-K, 10-Q, 8-K, 4 …). type: - string - 'null' id: description: Accession number (0000320193-25-000079). type: - string - 'null' period: description: Period of report, YYYY-MM-DD. format: date type: - string - 'null' sections: description: Extracted sections (finance.filings.get); null for search results. items: properties: item: description: Section id as requested (1A, 7, part1item2 …). type: string text: description: Section text. type: string required: - item - text type: object type: - array - 'null' symbol: description: Filer ticker when the vendor reports one. type: - string - 'null' text: description: >- Extracted document text (finance.filings.get); null for search results. type: - string - 'null' url: description: >- Primary document URL on www.sec.gov (or the vendor's rendering of it). type: - string - 'null' required: - id - form_type - filed_at - period - company - cik - symbol - url - description - text - sections type: object responses: ValidationError: content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Validation error (unknown field, bad cursor, bad routing) InsufficientCredits: content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Insufficient credits NotFound: content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Not found (method, or upstream object) RateLimited: content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limited upstream UpstreamFailed: content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: All providers failed Timeout: content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Timed out securitySchemes: ApiKeyAuth: description: AgentKey API key (ak_…). scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.