aVenture APISEC

Preview a public company from SEC EDGAR

View as Markdown
Resolves a publicly traded US company by ticker (preferred) or company-name query and returns the SEC EDGAR identity facts: legal name, former names, ticker, exchange, SIC industry, state of incorporation, headquarters, and whether it is an operating company. SEC supplies no brand name, website, or summary text — those stay enrichment-owned and are absent here. A 404 means the query matched no SEC registrant (e.g. a private company). Read live and never persisted.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

OR
X-API-Keystring

Admin API key for system-to-system write operations

OR
X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Query parameters

tickerstringOptional

Trading ticker symbol (preferred resolver)

namestringOptional

Company name query (used when no ticker is given)

Response

OK
cikstring

SEC Central Index Key, 10-digit zero-padded. The stable cross-sync join key.

exchangelist of strings

Listing exchange(s).

isOperatingboolean

True when SEC classifies this registrant as an operating company, false for a SPAC/trust/holding/shell vehicle.

matchedViaenum
How the query resolved to this registrant.
nameAliaslist of strings

Former registered legal names from SEC formerNames, most recent first.

nameLegalstring
Registered legal name from SEC filings.
otherCandidatelist of strings

Other registrants whose name also matched the query (legal names). Empty for an exact ticker resolution; non-empty signals an ambiguous name query.

tickerlist of strings

Trading ticker symbol(s).

einstring or nullOptional

Employer Identification Number (tax id), when SEC supplies one.

entityTypestring or nullOptional

SEC entity type. operating marks a real operating company; other marks a SPAC, trust, holding, or shell filing vehicle.

filerCategorystring or nullOptional
SEC filer size category.
fiscalYearEndstring or nullOptional

Fiscal year-end as MMDD.

headquartersCitystring or nullOptional
Headquarters city from the SEC business address.
headquartersCountrystring or nullOptional

Headquarters country code; often null for US filers.

headquartersPostalCodestring or nullOptional

Headquarters postal/ZIP code.

headquartersStatestring or nullOptional
Headquarters state or country from the SEC business address.
headquartersStreetstring or nullOptional
Headquarters street address from the SEC business address.
phonestring or nullOptional
Business phone from SEC filings.
sicCodestring or nullOptional
SIC industry code.
sicDescriptionstring or nullOptional
SIC industry description.
stateOfIncorporationstring or nullOptional

State or country of incorporation (SEC code).

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error