What can I search with?

Use a company name, official website, stock ticker or SEC CIK. Add an exchange to distinguish ticker symbols. You can also browse by incorporation country or SIC industry. Choose the company you need and keep its ID.

Which companies are covered?

This first release covers a fixed cohort of 500 leading U.S. public companies. Multiple share classes belong to one issuer. Some issuers are incorporated outside the United States. The coverage endpoint gives the current counts.

Deep adds a business description, legal identity, CIK, industry and additional addresses. Where supported by the sources, it includes a logo link, social links, a reported founding date and dated workforce counts. Each workforce count states whether it is headcount, full-time staff or full-time equivalents. Deep is included in the same pooled request.

Where does the data come from?

SEC issuer records and filings supply company identity, listings and business information. Reviewed company-controlled pages supply additional details. Source links, observation dates and workforce measurement dates stay with the data.

Which address comes back?

The profile returns the business address reported to the SEC. Deep includes the separately reported mailing address. An address is not independently verified as the current headquarters.

What do missing fields mean?

Null means the evidence does not support a value. Lists without selected facts are empty. A failed search means there is no match in this 500-company cohort.

GET /company

Company API

U.S. public companies, from name to profile.

Loading coverage...

Example response

GET /company/id/co_u5ntnpyvja2a?deep=true

{
  "id": "co_u5ntnpyvja2a",
  "name": "MICROSOFT CORP",
  "country": "US",
  "website": "https://www.microsoft.com/",
  
    { "exchange": "Nasdaq", "symbol": "MSFT" }
  ],
  
    "type": "business",
    "street": "ONE MICROSOFT WAY",
    "city": "REDMOND",
    "state": "WA",
    "postal": "98052-6399",
    "country": "US"
  },
  
}

1M requests · $20/mo. Get started

What comes back.

Stable company ID. Store it to retrieve the same profile later

name

Primary company name

country

Recorded incorporation country as ISO 3166-1 alpha-2, or null. It does not establish headquarters or operations

website

Recorded company website URL, or null when unknown

listings

Exchange and ticker pairs. An empty list does not establish private ownership

address

One recorded address, or null. Prefers headquarters, then business, registered, mailing; first recorded within a type

Find a company

Start with a company name, website, ticker or SEC CIK. Refine by incorporation country or SIC industry.

Read the profile

Get a company name, country, website, stock listings and one address. Missing fields stay null.

Keep the ID

Save the company ID to retrieve its profile later. Add deep=true for names, identifiers and industry details.

Loading coverage...

Make your first request.

One key works across the APIs. Copy a request in your language and get JSON back.

curl "https://api.parseapi.com/company?domain=microsoft.com" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Parse-Version: 2.0.0"

// Example response · 200
{
  "companies": [
    {
      "id": "co_u5ntnpyvja2a",
      "name": "MICROSOFT CORP",
      "country": "US",
      "website": "https://www.microsoft.com/",
      "listings": [
        {
          "exchange": "Nasdaq",
          "symbol": "MSFT"
        }
      ],
      "address": {
        "type": "business",
        "street": "ONE MICROSOFT WAY",
        "city": "REDMOND",
        "state": "WA",
        "postal": "98052-6399",
        "country": "US"
      },
      "match": {
        "field": "website",
        "value": "microsoft.com"
      }
    }
  ],
  "next": null
}

API reference SDKs Keys and authentication

Every response field

Response fields

idstring: Stable company ID. Store it to retrieve the same profile later
namestring: Primary company name
countrystring or null: Recorded incorporation country as ISO 3166-1 alpha-2, or null. It does not establish headquarters or operations
websitestring or null: Recorded company website URL, or null when unknown
listingsarray: Exchange and ticker pairs. An empty list does not establish private ownership
listings[].exchangestring: Recorded exchange or trading venue label; not a standardized MIC code
listings[].symbolstring: Ticker symbol on that exchange
addressobject or null: One recorded address, or null. Prefers headquarters, then business, registered, mailing; first recorded within a type
address.typestring: Recorded address type: registered, headquarters, business or mailing
address.streetstring or null: Street address, or null
address.citystring or null: City, or null
address.statestring or null: State code within the address country, using the same code format as the geography APIs, or null
address.postalstring or null: Postal code string, or null
address.countrystring or null: ISO 3166-1 alpha-2 address country, or null

Deep fields

deep.legal_namestring or null: Legal entity name, or null
deep.aliasesarray: Other company names
deep.jurisdictionobject or null: Recorded registration location as country and state codes, or null
deep.jurisdiction.countrystring: Registration country as ISO 3166-1 alpha-2
deep.jurisdiction.statestring or null: State code within the registration country, such as WA, or null
deep.statusstring or null: Recorded legal entity status; does not establish current business activity, website availability or listing status
deep.domainsarray: Other associated domains, excluding the core website hostname. Includes all recorded domains when the core URL is unknown
deep.domains[].domainstring: Associated hostname, normalized to lowercase ASCII without a conventional www. prefix
deep.domains[].urlstring or null: Recorded URL for this domain, or null; never inferred from a domain alone
deep.identifiersarray: Identifiers paired with their type and issuing authority
deep.identifiers[].typestring: SEC identifier type: cik
deep.identifiers[].authoritystring: Issuing authority
deep.identifiers[].valuestring: Identifier string. Preserve leading zeros
deep.incorporatedstring or null: Legal entity incorporation date as YYYY-MM-DD, or null
deep.addressesarray: Other recorded addresses, excluding the address returned in core, in recorded order
deep.addresses[].typestring: Recorded address type: registered, headquarters, business or mailing
deep.addresses[].streetstring or null: Street address, or null
deep.addresses[].citystring or null: City, or null
deep.addresses[].statestring or null: State code within the address country, with the same formatting as the core address, or null
deep.addresses[].postalstring or null: Postal code string, or null
deep.addresses[].countrystring or null: ISO 3166-1 alpha-2 address country, or null
deep.industriesarray: Industry classifications, each with its type and code
deep.industries[].typestring: Classification type, such as sic
deep.industries[].codestring: Industry code string
deep.industries[].namestring or null: Industry name, or null
deep.parentstring or null: Known parent company ID in this directory, or null
deep.descriptionstring or null: Business summary based on company filings, or null
deep.logostring or null: Recorded logo URL, or null. A reference does not grant permission to reuse the asset
deep.social_profilesarray: Recorded social profiles; empty when none are recorded
deep.social_profiles[].platformstring or null: Social platform, or null when unknown
deep.social_profiles[].urlstring: Recorded HTTP(S) profile URL
deep.social_profiles[].handlestring or null: Recorded account handle, or null when unknown
deep.phone_numbersarray: Selected public business phone numbers; omitted when none are selected
deep.phone_numbers[].numberstring: Source-recorded phone number; no reachability verification
deep.phone_numbers[].typestring or null: Source-reported purpose, such as support, or null when unknown
deep.email_addressesarray: Selected public business email addresses; omitted when none are selected
deep.email_addresses[].addressstring: Source-recorded email address; no delivery verification
deep.email_addresses[].typestring or null: Source-reported purpose, such as support, or null when unknown
deep.foundednull or object: Reported founding date and precision, or null. Separate from legal incorporation
deep.founded.valuestring: YYYY, YYYY-MM or YYYY-MM-DD, matching the recorded precision without invented date components
deep.founded.precisionstring: year, month or day
deep.employeesobject or null: Reported workforce count with its measurement basis, date and organization scope, or null
deep.employees.countinteger: Reported number of employees, including a supported zero
deep.employees.basisstring: headcount, full_time or full_time_equivalent; omitted on older headcount responses
deep.employees.as_ofstring: Explicit measurement date in YYYY-MM-DD form
deep.employees.scopestring: legal_entity or consolidated_group, as supported by the source
deep.employees.methodstring: reported
deep.employees.approximateboolean: Whether the source calls the count approximate
deep.sourcesarray: Attribution for returned business details and workforce observations
deep.sources[].typestring: website or sec_filing
deep.sources[].urlstring: Page that supplied the attributed fields
deep.sources[].fieldsarray: Returned fields supplied by this source: description, logo, social_profiles, founded, employees, phone_numbers or email_addresses
deep.sources[].observed_atstring: When the page was read; not when each company fact changed
deep.sources[].updated_atstring or null: Source-reported update timestamp, or null; never inferred from observed_at or a date without a time

QUESTIONS

What can I search with?: Use a company name, official website, stock ticker or SEC CIK. Add an exchange to distinguish ticker symbols. You can also browse by incorporation country or SIC industry. Choose the company you need and keep its ID.
Which companies are covered?: This first release covers a fixed cohort of 500 leading U.S. public companies. Multiple share classes belong to one issuer. Some issuers are incorporated outside the United States. The coverage endpoint gives the current counts.
What does deep add?: Deep adds a business description, legal identity, CIK, industry and additional addresses. Where supported by the sources, it includes a logo link, social links, a reported founding date and dated workforce counts. Each workforce count states whether it is headcount, full-time staff or full-time equivalents. Deep is included in the same pooled request.
Where does the data come from?: SEC issuer records and filings supply company identity, listings and business information. Reviewed company-controlled pages supply additional details. Source links, observation dates and workforce measurement dates stay with the data.
Which address comes back?: The profile returns the business address reported to the SEC. Deep includes the separately reported mailing address. An address is not independently verified as the current headquarters.
What do missing fields mean?: Null means the evidence does not support a value. Lists without selected facts are empty. A failed search means there is no match in this 500-company cohort.

Build with company data.

One key for Company and the rest of ParseAPI.

Start includes 1M API requests a month for $20/mo.

Ready for busy moments.Start includes 1,800 requests per minute, with extra capacity for bursts. Rate limits

Get started Compare plans Read the docs