Search public company filings

This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.

Pricing: 1 credit per successful filings search.

Use this for public-company research. It is not a substitute for company or people discovery.

Body parameters

company_namerequired
string
Public company name.
filing_types · optional
array<string>
Optional filing types. Default: ["10-K", "10-Q"].

Name	Type	Description
company_namerequired	string	Public company name.
filing_types	array<string>	Optional filing types. Default: ["10-K", "10-Q"].

Errors

Status	Meaning
400	The search/provider rejected the request.
422	company_name is required by the request model.
401	Invalid API key or missing auth.
403	Missing search:run scope.

Example

bash

curl -X POST "https://app.autotouch.ai/api/search/filings" \
  -H "Authorization: Bearer stk_your_key_id.your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Apple",
    "filing_types": ["10-K", "10-Q"]
  }'

Request body

json

{
  "company_name": "Apple",
  "filing_types": ["10-K", "10-Q"]
}

Response example

json

{
  "query": "Apple",
  "items": [
    {
      "form_type": "10-K",
      "filed_at": "2025-11-01",
      "url": "https://www.sec.gov/Archives/...",
      "title": "Annual report"
    }
  ],
  "total_found": 1,
  "billable_results": 1,
  "credits_used": 1,
  "pricing_rule": "1 credit per successful search",
  "metadata": {"cik": "0000320193", "filing_types_searched": ["10-K", "10-Q"]}
}