# Eckari US Company SEC Filings > Eckari US Company SEC Filings is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-09). Retrieves a paginated list of SEC EDGAR filings for a US public company identified by ticker symbol or CIK number ## Facts - Endpoint: GET https://api.eckari.com/v1/companies/us/%7Bid%7D/filings?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-09 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/eckari-us-company-sec-filings-210a98fb - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i0jumtbEqWNd3_4RZa0pn Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability eckari-us-company-sec-filings-210a98fb ``` Example prompt: Pull the last 5 10-K annual report filings for Apple (ticker AAPL) from SEC EDGAR — I need the filing dates and document URLs. ## When to prefer this Choose this endpoint when you need structured, filterable access to SEC EDGAR filing metadata for US public companies by ticker or CIK, with support for form-type filtering and date-range scoping. It is preferable to scraping EDGAR directly because it handles ticker-to-CIK resolution, near-live freshness, and consistent JSON output. Use it over general web search when you need authoritative, machine-readable filing records with direct document links. ## Known failure modes - Ticker not found in SEC index returns NOT_FOUND (non-billable) - Invalid CIK format returns a validation error - Unknown form type filter returns empty results rather than an error - Offset beyond total results returns an empty items array with has_more false - Malformed date format in 'since' parameter returns a schema validation error ## How this service works Eckari is the machine-native utility layer for capabilities agents do not already have. Every route is a provider-neutral capability with channel pricing for Eckari account keys and accountless x402 payment. ## Output Returns a JSON object containing the company's CIK, name, and a paginated list of filings. Each filing includes the form type, filing date, report date, accession number, direct document URL, EDGAR index URL, XBRL flags, file number, and file size in bytes. Pagination metadata (total count, offset, has_more) is included to support multi-page retrieval. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string" }, "pathParams": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "pattern": "^(?:(?:[Cc][Ii][Kk])?[0-9]{1,10}|[A-Za-z][A-Za-z0-9.-]{0,9})$", "maxLength": 13, "minLength": 1, "description": "SEC CIK or exchange ticker symbol. All digits is read as a CIK (leading zeros and an EDGAR CIK prefix are both accepted: 320193, 0000320193, CIK0000320193); anything else is read as a ticker (1-10 characters starting with a letter) and matched exactly, case-insensitively, against the SEC listed-security index — AAPL, aapl and BRK-B all work. Company names are not accepted: resolve one with company.us.resolve. A ticker with no SEC index entry returns NOT_FOUND, which is not a billable result." } }, "additionalProperties": false }, "queryParams": { "type": "object", "properties": { "form": { "type": "string", "pattern": "^[A-Za-z0-9 ,/.-]+$", "maxLength": 200, "description": "Comma-separated EDGAR form types to keep, e.g. \"10-K,10-Q,8-K\". Matching is exact and case-insensitive; omit to return every form." }, "limit": { "type": "integer", "default": 5, "maximum": 100, "minimum": 1, "description": "Maximum number of filings to return from the filtered set. Defaults to 5 so a first call stays small; raise it explicitly when you need more." }, "since": { "type": "string", "format": "date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "description": "Keep only filings with a filing_date on or after this ISO date (YYYY-MM-DD)." }, "offset": { "type": "integer", "default": 0, "minimum": 0, "description": "Zero-based offset into the filtered set, for paging. Pass page.next_offset from the previous response." } }, "additionalProperties": false } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "data": { "cik": "0000320193", "name": "Apple Inc.", "page": { "limit": 2, "total": 11, "offset": 0, "has_more": true, "returned": 2, "next_offset": 2 }, "items": [ { "act": "34", "form": "10-K", "is_xbrl": true, "index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm", "item_codes": [], "size_bytes": 9392337, "file_number": "001-36743", "filing_date": "2025-10-31", "report_date": "2025-09-27", "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm", "is_inline_xbrl": true, "accession_number": "0000320193-25-000079", "primary_document": "aapl-20250927.htm", "primary_doc_description": "10-K" }, { "act": "34", "form": "10-K", "is_xbrl": true, "index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm", "item_codes": [], "size_bytes": 9759333, "file_number": "001-36743", "filing_date": "2024-11-01", "report_date": "2024-09-28", "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm", "is_inline_xbrl": true, "accession_number": "0000320193-24-000123", "primary_document": "aapl-20240928.htm", "primary_doc_description": "10-K" } ], "query": { "id": "AAPL", "form": "10-K", "since": null, "matched_by": "ticker" }, "has_more_history": true }, "meta": { "source": "sec_edgar", "version": "3.0.0", "freshness": "near_live", "capability": "company.us.filings" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-us-company-sec-filings-210a98fb/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)