Company API
Find a company by name, website, ticker or registration identifier.
Connect your company records to the right issuer. Keep its stable ID when joining profiles and SEC records. Search 500 selected issuers listed in the U.S. by name, website, ticker or SEC CIK. Get its name, incorporation country, website, listings and one recorded address in one response. Try the Company API.
Find a company
curl "https://api.parseapi.com/company/domain/apple.com" \
-H "X-API-Key: YOUR_API_KEY" \
-H "X-API-Version: 2.2.0"{
"id": "co_g9puf74dwzwn",
"name": "Apple Inc.",
"country": "US",
"website": "https://www.apple.com/",
"listings": [
{
"exchange": "Nasdaq",
"symbol": "AAPL"
}
],
"address": {
"type": "business",
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal": "95014",
"country": "US"
},
"aliases": [
"APPLE INC",
"APPLE COMPUTER INC",
"APPLE COMPUTER INC/ FA"
],
"jurisdiction": {
"country": "US",
"state": "CA"
},
"identifiers": [
{
"type": "cik",
"authority": "sec",
"value": "0000320193"
}
],
"addresses": [
{
"type": "mailing",
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal": "95014",
"country": "US"
}
],
"industries": [
{
"type": "sic",
"code": "3571",
"name": "Electronic Computers"
}
],
"description": "Apple designs, manufactures and markets smartphones, personal computers, tablets, wearables and accessories, and sells related services.",
"logo": "https://www.apple.com/ac/structured-data/images/knowledge_graph_logo.png?202609042047",
"social_profiles": [
{
"platform": "youtube",
"url": "https://www.youtube.com/user/Apple"
},
{
"platform": "linkedin",
"url": "https://www.linkedin.com/company/apple"
},
{
"platform": "facebook",
"url": "https://www.facebook.com/Apple"
},
{
"platform": "twitter",
"url": "https://www.twitter.com/Apple"
}
],
"employees": {
"count": 166000,
"as_of": "2025-09-27",
"scope": "consolidated_group",
"approximate": true,
"basis": "full_time_equivalent"
},
"phone_numbers": [
{
"number": "(408) 996-1010",
"country": null,
"e164": "+14089961010"
}
]
}Website, ticker and SEC CIK lookups return one company object: /company/domain/apple.com, /company/ticker/AAPL or /company/cik/0000320193. CIK accepts 1 to 10 digits and preserves its normalized identity. Add exchange=Nasdaq if a ticker needs a venue. No match returns 404; an ambiguous lookup returns 409 rather than choosing a company.
GET /company/ticker/{ticker}API Explorer ↗Get one company by ticker, with an optional exchange
Parameters
GET /companyAPI Explorer ↗Search company names or discover profiles
Parameters
- qstring · query · optional
Company name or alias text. Use at most one of q, domain, ticker or identifier; without a selector, country or an industry pair is required. Name matches rank by exact name, prefix, then substring. Filter-only results use stable ID order.
Length: 1 to 300 characters
- domainstring · query · optional
Website hostname or HTTP(S) URL. Matches the exact normalized host, including subdomains; a conventional www. prefix is removed.
Length: 1 to 4096 characters
- tickerstring · query · optional
Exact ticker symbol, case-insensitive. Use exchange to narrow the listing.
Length: 1 to 64 characters
- identifierstring · query · optional
SEC CIK as a string, with or without leading zeros. The optional authority is sec.
Length: 1 to 256 characters
- countrystring · query · optional
Filter the profile country by ISO 3166-1 alpha-2 code. Case-insensitive.
Pattern:
^[A-Za-z]{2}$- industrystring · query · optional
Exact four-digit SIC industry code. Requires industry_type=sic. Matches recorded classifications only; no inferred classifications or prefix matching.
Pattern:
^[0-9]{4}$- industry_typestring · query · optional
Industry classification namespace. Currently sic; requires industry.
Values:
sic- exchangestring · query · optional
Exchange name, case-insensitive. Supported only with ticker.
Length: 1 to 128 characters
- limitinteger · query · optional
Maximum companies per page.
Default:
20Range: 1 to 50
- cursorstring · query · optional
Opaque next cursor from the previous response. Keep the selector, filters and limit unchanged. An invalid or expired cursor returns 400; restart the search.
Length: 1 to 1024 characters
- prettyboolean · query · optional
Format the JSON response for reading.
Default:
false
curl "https://api.parseapi.com/company?q=Apple+Inc." \
-H "X-API-Key: YOUR_API_KEY" \
-H "X-API-Version: 2.2.0"{
"companies": [
{
"id": "co_g9puf74dwzwn",
"name": "Apple Inc.",
"country": "US",
"website": "https://www.apple.com/",
"listings": [
{
"exchange": "Nasdaq",
"symbol": "AAPL"
}
],
"address": {
"type": "business",
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal": "95014",
"country": "US"
},
"match": {
"field": "name",
"value": "Apple Inc."
},
"aliases": [
"APPLE INC",
"APPLE COMPUTER INC",
"APPLE COMPUTER INC/ FA"
],
"jurisdiction": {
"country": "US",
"state": "CA"
},
"identifiers": [
{
"type": "cik",
"authority": "sec",
"value": "0000320193"
}
],
"addresses": [
{
"type": "mailing",
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal": "95014",
"country": "US"
}
],
"industries": [
{
"type": "sic",
"code": "3571",
"name": "Electronic Computers"
}
],
"description": "Apple designs, manufactures and markets smartphones, personal computers, tablets, wearables and accessories, and sells related services.",
"logo": "https://www.apple.com/ac/structured-data/images/knowledge_graph_logo.png?202609042047",
"social_profiles": [
{
"platform": "youtube",
"url": "https://www.youtube.com/user/Apple",
"handle": null
},
{
"platform": "linkedin",
"url": "https://www.linkedin.com/company/apple",
"handle": null
},
{
"platform": "facebook",
"url": "https://www.facebook.com/Apple",
"handle": null
},
{
"platform": "twitter",
"url": "https://www.twitter.com/Apple",
"handle": null
}
],
"employees": {
"count": 166000,
"as_of": "2025-09-27",
"scope": "consolidated_group",
"approximate": true,
"basis": "full_time_equivalent"
},
"phone_numbers": [
{
"number": "(408) 996-1010",
"country": null,
"e164": "+14089961010",
"type": "business"
}
]
}
],
"next": null
}Find a company with one selector: q for a name, domain for a website, ticker for a listing, or identifier for a SEC CIK. Add country to narrow the company country, exchange with a ticker, or authority with an identifier.
When connecting a ticker to SEC records on a paid plan, request /company/ticker/AAPL. The same response automatically includes the SEC CIK in identifiers and source-qualified profile facts. Confirm the match and save its id for later profile reads. Names and ticker symbols can change; this endpoint does not resolve a ticker for a historical date.
To discover companies, send country=US, an exact industry pair such as industry=7372&industry_type=sic, or both. These filters also narrow a name, domain, ticker or identifier search. Country refers to the recorded profile country; unknown values do not match. SIC codes keep all four digits. Filter-only results have match: { field: "filters", value: null } and use stable ID order.
More searches and pagination
/company?q=Apple%20Inc.
/company?ticker=AAPL&exchange=Nasdaq
/company?identifier=0000320193&authority=sec
Name matches rank exact names first, then prefixes and contained matches. Ticker matches include the matched exchange. Identifier matches include type and authority; keep identifier values as strings to preserve leading zeros.
Search returns up to 20 companies. Set limit from 1 to 50. Pass a non-null next as cursor with the same selector, filters and limit. This example retrieves two pages with one company per page.
const url = new URL('https://api.parseapi.com/company?q=Micro&limit=1');
const headers = { 'X-API-Key': 'YOUR_API_KEY', 'X-API-Version': '2.2.0' };
async function readPage() {
const response = await fetch(url, { headers });
const data = await response.json();
if (!response.ok) throw new Error(data.message);
return data;
}
const first = await readPage();
if (first.next) {
url.searchParams.set('cursor', first.next);
const second = await readPage();
console.log(second.companies);
}Response fields
- companiesLink to companiesarray
- Matching company profiles in selector rank order, or stable ID order for filter-only discovery. An empty array means no match in this directory edition
- companies[].match.fieldLink to companies[].match.fieldstring
- The selected field that matched: name, legal_name, aliases, website, domains, listings or identifiers; filters for discovery without a selector
- companies[].match.valueLink to companies[].match.valuestring or null
- Matched name, normalized domain, ticker or identifier value; null for filter-only discovery
- companies[].match.exchangeLink to companies[].match.exchangestring
- Present for ticker matches: the matched exchange or trading venue label
- companies[].match.typeLink to companies[].match.typestring
- Present for identifier matches: the matching identifier type
- nextLink to nextstring or null
- Opaque next-page cursor, or null. Reuse the same selector, filters and limit
Keep the company ID
Store the chosen company's id to retrieve it later. IDs begin with co_ followed by 12 characters; treat them as opaque values. Names, domains and ticker symbols can match more than one company.
website is one recorded URL, or null when no URL is recorded. listings keeps each symbol with its exchange or trading venue label; exchange labels are not standardized MIC codes.
Profile fields
Response fields
- idLink to idstring
- Stable company ID. Store it to retrieve the same profile later
- nameLink to namestring
- Primary company name
- countryLink to countrystring or null
- Recorded incorporation country as ISO 3166-1 alpha-2, or null. It does not establish headquarters or operations
- websiteLink to websitestring or null
- Recorded company website URL, or null when unknown
- listingsLink to listingsarray
- Exchange and ticker pairs. An empty list does not establish private ownership
- listings[].exchangeLink to listings[].exchangestring
- Recorded exchange or trading venue label; not a standardized MIC code
- listings[].symbolLink to listings[].symbolstring
- Ticker symbol on that exchange
- addressLink to addressobject or null
- One recorded address, or null. Prefers headquarters, then business, registered, mailing; first recorded within a type
- address.typeLink to address.typestring
- Recorded address type: registered, headquarters, business or mailing
- address.streetLink to address.streetstring or null
- Street address, or null
- address.cityLink to address.citystring or null
- City, or null
- address.stateLink to address.statestring or null
- State code within the address country, using the same code format as the geography APIs, or null
- address.postalLink to address.postalstring or null
- Postal code string, or null
- address.countryLink to address.countrystring or null
- ISO 3166-1 alpha-2 address country, or null
Unknown everyday fields are null. Optional profile facts and collections are omitted when unavailable. The default address is a recorded headquarters when available, otherwise a business, registered or mailing address, in that order. Its type tells you which address it is. Street, city and postal values stay as recorded; country and state codes use the same format as the geography APIs. If no address is recorded, address is null.
Included profile details
Paid plans automatically include available business details, identifiers, industry, additional addresses and dated workforce counts. Other names and domains appear only when recorded; a legal name is omitted when it repeats name. addresses contains the remaining recorded addresses without repeating the default address. These details use the same pooled request. It appears on each company in a search, or on any direct profile lookup by website, ticker, CIK or ID. Free returns the ordinary company profile. Existing explicit HTTP depth options remain supported; deep=false keeps its existing core behavior on these Company routes. Included additional fields appear directly on the company record, and unavailable optional fields and empty optional collections are omitted.
status is the recorded legal entity status, not a check of trading activity or website availability. domains contains other associated domains with their recorded URLs, or null when only the domain is known. The domain used by website is not repeated. If website is null, all associated domains remain in the requested detail.
jurisdiction uses separate country and state codes, consistent with the geography APIs. The state is null when only a registration country is recorded. The company's recorded country can differ from an address's country. parent is the recorded parent company's ID, when recorded.
Descriptive profiles also include description, a logo URL, social_profiles, founded when recorded. Unavailable details are omitted. founded preserves a reported year, month or day and is separate from the legal incorporated date. social_profiles contains a url and any known platform or handle. Unknown account metadata is omitted. Logo and social URLs are references; they do not grant rights to reuse assets or verify ownership.
employees gives a reported workforce count and its as_of measurement date. scope covers one legal entity (legal_entity) or the parent and its consolidated subsidiaries (consolidated_group). basis distinguishes people (headcount), full-time employees (full_time) and working hours expressed as full-time roles (full_time_equivalent). Reported counts may be rounded. Annual filings often describe an earlier workforce. Unknown counts are omitted, and a reported zero stays zero.
When sourced, phone_numbers and email_addresses contain selected public business contacts. Each record preserves its number or address. A specific source-reported purpose, such as fax or customer support, appears in type; generic business and unknown labels are omitted. These collections are omitted when no contacts are selected. They do not establish reachability, delivery or ownership.
curl "https://api.parseapi.com/company/domain/apple.com" \
-H "X-API-Key: YOUR_API_KEY" \
-H "X-API-Version: 2.2.0"{
"id": "co_g9puf74dwzwn",
"name": "Apple Inc.",
"country": "US",
"website": "https://www.apple.com/",
"listings": [
{
"exchange": "Nasdaq",
"symbol": "AAPL"
}
],
"address": {
"type": "business",
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal": "95014",
"country": "US"
},
"aliases": [
"APPLE INC",
"APPLE COMPUTER INC",
"APPLE COMPUTER INC/ FA"
],
"jurisdiction": {
"country": "US",
"state": "CA"
},
"identifiers": [
{
"type": "cik",
"authority": "sec",
"value": "0000320193"
}
],
"addresses": [
{
"type": "mailing",
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal": "95014",
"country": "US"
}
],
"industries": [
{
"type": "sic",
"code": "3571",
"name": "Electronic Computers"
}
],
"description": "Apple designs, manufactures and markets smartphones, personal computers, tablets, wearables and accessories, and sells related services.",
"logo": "https://www.apple.com/ac/structured-data/images/knowledge_graph_logo.png?202609042047",
"social_profiles": [
{
"platform": "youtube",
"url": "https://www.youtube.com/user/Apple"
},
{
"platform": "linkedin",
"url": "https://www.linkedin.com/company/apple"
},
{
"platform": "facebook",
"url": "https://www.facebook.com/Apple"
},
{
"platform": "twitter",
"url": "https://www.twitter.com/Apple"
}
],
"employees": {
"count": 166000,
"as_of": "2025-09-27",
"scope": "consolidated_group",
"approximate": true,
"basis": "full_time_equivalent"
},
"phone_numbers": [
{
"number": "(408) 996-1010",
"country": null,
"e164": "+14089961010"
}
]
}Recorded response excerpt for Apple, showing a dated workforce count. Other profile fields are omitted here.
{
"id": "co_g9puf74dwzwn",
"employees": {
"count": 166000,
"as_of": "2025-09-27",
"scope": "consolidated_group",
"approximate": true,
"basis": "full_time_equivalent"
}
}Response fields
- legal_nameLink to legal_namestring or null
- Different legal name; omitted when it repeats name or is unknown
- aliasesLink to aliasesarray
- Other company names
- jurisdictionLink to jurisdictionobject or null
- Recorded registration location as country and state codes, omitted when unknown
- jurisdiction.countryLink to jurisdiction.countrystring
- Registration country as ISO 3166-1 alpha-2
- jurisdiction.stateLink to jurisdiction.statestring or null
- State code within the registration country, such as WA, or null when only the country is known
- statusLink to statusstring or null
- Recorded legal entity status; does not establish current business activity, website availability or listing status
- domainsLink to domainsarray
- Other associated domains, excluding the core website hostname. Includes all recorded domains when the core URL is unknown
- domains[].domainLink to domains[].domainstring
- Associated hostname, normalized to lowercase ASCII without a conventional www. prefix
- domains[].urlLink to domains[].urlstring or null
- Recorded URL for this domain, or null; never inferred from a domain alone
- identifiersLink to identifiersarray
- Identifiers paired with their type and issuing authority
- identifiers[].typeLink to identifiers[].typestring
- SEC identifier type: cik
- identifiers[].valueLink to identifiers[].valuestring
- Identifier string. Preserve leading zeros
- incorporatedLink to incorporatedstring or null
- Legal entity incorporation date as YYYY-MM-DD, omitted when unknown
- addressesLink to addressesarray
- Other recorded addresses, excluding the address returned in core, in recorded order
- addresses[].typeLink to addresses[].typestring
- Recorded address type: registered, headquarters, business or mailing
- addresses[].streetLink to addresses[].streetstring or null
- Street address, or null
- addresses[].cityLink to addresses[].citystring or null
- City, or null
- addresses[].stateLink to addresses[].statestring or null
- State code within the address country, with the same formatting as the core address, or null
- addresses[].postalLink to addresses[].postalstring or null
- Postal code string, or null
- addresses[].countryLink to addresses[].countrystring or null
- ISO 3166-1 alpha-2 address country, or null
- industriesLink to industriesarray
- Industry classifications, each with its type and code
- industries[].typeLink to industries[].typestring
- Classification type, such as sic
- industries[].codeLink to industries[].codestring
- Industry code string
- industries[].nameLink to industries[].namestring or null
- Industry name, omitted when unknown
- parentLink to parentstring or null
- Known parent company ID in this directory, omitted when unknown
- descriptionLink to descriptionstring or null
- Business summary based on company filings, omitted when unknown
- logoLink to logostring or null
- Recorded logo URL, or null. A reference does not grant permission to reuse the asset
- phone_numbersLink to phone_numbersarray
- Selected public business phone numbers; omitted when none are selected
- phone_numbers[].numberLink to phone_numbers[].numberstring
- Source-recorded phone number; no reachability verification
- phone_numbers[].typeLink to phone_numbers[].typestring or null
- Specific source-reported purpose, such as fax; omitted for unknown or generic business labels
- email_addressesLink to email_addressesarray
- Selected public business email addresses; omitted when none are selected
- email_addresses[].addressLink to email_addresses[].addressstring
- Source-recorded email address; no delivery verification
- email_addresses[].typeLink to email_addresses[].typestring or null
- Specific source-reported purpose, such as customer_support; omitted for unknown or generic business labels
- foundedLink to foundednull or object
- Reported founding date and precision, omitted when unknown. Separate from legal incorporation
- founded.valueLink to founded.valuestring
- YYYY, YYYY-MM or YYYY-MM-DD, matching the recorded precision without invented date components
- founded.precisionLink to founded.precisionstring
- year, month or day
- employeesLink to employeesobject or null
- Reported workforce count with its measurement basis, date and organization scope, omitted when unknown. Reported counts may be rounded
- employees.countLink to employees.countinteger
- Reported number of employees, including a supported zero
- employees.basisLink to employees.basisstring
- headcount, full_time or full_time_equivalent; omitted on older headcount responses
- employees.as_ofLink to employees.as_ofstring
- Explicit measurement date in YYYY-MM-DD form
- employees.scopeLink to employees.scopestring
- legal_entity covers one legal entity; consolidated_group covers the parent and its consolidated subsidiaries
- phone_numbers[].countryLink to phone_numbers[].countrystring or null
- Country of the phone record’s linked address, or null; never inferred from incorporation
- phone_numbers[].e164Link to phone_numbers[].e164string or null
- Source-recorded E.164 number, or null; no reachability verification
Access and errors
Use your API key with X-API-Version: 2.2.0. Company requests use the normal pooled request allowance.
A search with no matches returns 200 with an empty companies array. An unknown company lookup returns 404. A direct lookup with multiple matches returns 409 ambiguous_company; use a stable company ID or add an exchange for ticker lookup. Invalid options or an expired cursor return 400; restart the search for a fresh cursor. Authentication uses 401 or 403, request limits use 429, and an unavailable directory returns 503. Error responses include code, message, docs and request_id.