SEC EDGAR

SEC EDGAR Company Lookup API

Start here. This is the entry point that turns a NAME into the id every other SEC EDGAR endpoint needs: you hold a ticker like AAPL or a company name, and EDGAR is keyed by CIK (0000320193). Returns matching filers with symbol, listing exchange, a match-quality tier, and ready-made submissions / company-facts / EDGAR URLs, as JSON. Costs 1 credit per request.

POST/api/v1/sec/lookup

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Ticker, company name, or a fragment of one (1-200 characters). Every row carries the tier it matched on in its `match` field: ticker (exact symbol), name (exact name), name_prefix, ticker_prefix, then name_contains. Results are ordered by tier, not alphabetically, so Apple Inc. outranks Apple Hospitality REIT.

Example: AAPL

limitintegerdefault:10

Rows to return, 1-100. This SIZES the response - it is not a page param. There is no pagination on this endpoint.

Example: 25

exchangeenum<string>

Restrict to one listing venue. Matched case-insensitively, so "Nasdaq" works as well as "NASDAQ". Note that filers the SEC lists with no exchange at all are excluded by ANY value here - leave it unset if you want those.

NASDAQ — Nasdaq-listed filers.
NYSE — New York Stock Exchange.
OTC — Over-the-counter.
CBOE — Cboe-listed filers.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Resolve the ticker to a CIK first, then use it everywhere else.
matches = client.sec.lookup("AAPL")
cik = matches["data"]["results"][0]["cik"]

profile = client.sec.company(cik=cik)
print(profile)

Response

"query": "apple",

"exchange": null,

"total_results": 6,

"limit": 10,

"count": 6,

"response_time": 2748,

"credits_used": 1,

"credits_remaining": 4820

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Resolve the ticker to a CIK first, then use it everywhere else. matches = client.sec.lookup("AAPL") cik = matches["data"]["results"][0]["cik"] profile = client.sec.company(cik=cik) print(profile)