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.

GET /company/domain/{domain}API Explorer ↗

Get one company by website

Parameters

domainstring · path · required

public website hostname

Length: 0 to 254 characters

prettyboolean · query · optional

Format the JSON response for reading.

Default: false

Request

curl "https://api.parseapi.com/company/domain/apple.com" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Version: 2.2.0"
Example responsePaid plan
{
  "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

tickerstring · path · required

trading symbol

Length: 0 to 64 characters

exchangestring · query · optional

Recorded exchange name; use it when a ticker matches more than one company.

Length: 0 to 128 characters

prettyboolean · query · optional

Format the JSON response for reading.

Default: false

GET /company/cik/{cik}API Explorer ↗

Get one company by SEC CIK

Parameters

cikstring · path · required

SEC Central Index Key

Pattern: ^[0-9]{1,10}$

prettyboolean · query · optional

Format the JSON response for reading.

Default: false

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

authoritystring · query · optional

Identifier authority, case-insensitive. Supported only with identifier.

Length: 1 to 128 characters

Pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.:/-]{0,127}$

limitinteger · query · optional

Maximum companies per page.

Default: 20

Range: 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

Request

curl "https://api.parseapi.com/company?q=Apple+Inc." \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Version: 2.2.0"
Example responsePaid plan
{
  "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
companies[].match.authorityLink to companies[].match.authoritystring
Present for identifier matches: the matching issuing authority
nextLink to nextstring or null
Opaque next-page cursor, or null. Reuse the same selector, filters and limit

Keep the company ID

GET /company/id/{id}API Explorer ↗

Retrieve one company profile

Parameters

idstring · path · required

Stable company ID returned by search.

Pattern: ^co_[23456789abcdefghjkmnpqrstuvwxyz]{12}$

prettyboolean · query · optional

Format the JSON response for reading.

Default: false

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.

Request

curl "https://api.parseapi.com/company/domain/apple.com" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Version: 2.2.0"
Example responsePaid plan
{
  "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

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[].authorityLink to identifiers[].authoritystring
Issuing authority
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
social_profilesLink to social_profilesarray
Recorded social profiles; omitted when none are recorded
social_profiles[].platformLink to social_profiles[].platformstring or null
Social platform; omitted when unknown
social_profiles[].urlLink to social_profiles[].urlstring
Recorded HTTP(S) profile URL
social_profiles[].handleLink to social_profiles[].handlestring or null
Recorded account handle; omitted when unknown
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.

Open the company directory ↗