company.us.resolve

US Company Resolution

Turn a ticker or company-name fragment into the SEC CIK that every other US company capability takes, ranked deterministically.

Example answer

Ask

Which SEC filer and CIK does the company name "Apple" belong to?

GET /v1/companies/us/resolve?q=AAPL&limit=3

Eckari

{
  "query": "AAPL",
  "match_type": "ticker_exact",
  "items": [
    {
      "cik": "0000320193",
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "exchange": "Nasdaq"
    }
  ],
  "page": {
    "limit": 3,
    "offset": 0,
    "returned": 1,
    "total": 1,
    "has_more": false,
    "next_offset": null
  }
}

Source: SEC EDGAR
Freshness: Near live
Price: $0.002

Version: 2.0.0
Transport: HTTP / MCP
Coverage: US

Use this when

Which SEC filer and CIK does the company name "Apple" belong to?
What is the CIK for the ticker AAPL?
You have a US company name and need the SEC identifier before calling another US company capability.
You need to map a portfolio of names or tickers to SEC CIK numbers.
You want the exchange a US listed company trades on.
You need to see the candidate filers behind an ambiguous company name.

Don't use this when

You already have a ticker or a CIK and want profile or filings — company.us.profile, company.us.filings and company.us.filings.latest accept either identifier directly, so this extra call is unnecessary.
You need to know whether a company is an SEC filer at all — this searches only the listed-security index, so private filers, funds and most foreign filers are absent even though they file; no result is not evidence of no filings.
You need filings — use company.us.filings or company.us.filings.latest.
The company is UK registered — use company.uk.search.
You need a global legal entity identifier rather than an SEC identifier — use entity.lei.search.

If the user has asked you to inspect a specific website, page or URL, use your browsing tool instead — this capability only returns the SEC EDGAR record.

Input

qstringrequired

Ticker symbol (e.g. AAPL) or company-name fragment (e.g. Apple). Matching is case-insensitive and trimmed; no fuzzy matching is applied.

limitintegerdefault 10

Maximum number of ranked matches to return. Ranking is applied before the limit; page.total reports how many matched in full.

What the result means

querystring

The trimmed query as interpreted by the resolver.

match_typestring, null

Strongest match class present in the result set, or null when nothing matched. ticker_exact beats name_exact beats name_prefix beats name_contains.

itemsarray

Matches ordered by match class, then registered name ascending, then CIK ascending, then ticker ascending. A company with several listed securities appears once per ticker.

pageobject

Paging state for items (ADR-008 §2). This capability accepts no offset, so it always returns the first page.

Provenance

Source: SEC EDGAR
Freshness: Near live · read at request time, not cached
Region: US

Access

Over MCP: company_us_resolve
Over HTTP: GET https://api.eckari.com/v1/companies/us/resolve
Price: $0.002 per call over x402. Account access $0.0015 when that rail opens.