GET /company

Company API

Find the company behind a name, website or ticker.

Search by

Search by company name.

Refine search
Example response

GET /company/id/co_at73t5dva4tt?deep=true

MICROSOFT CORP

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

1M requests · $20/mo. Get started

What comes back.

id

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

name

Primary company name

country

Recorded company country as ISO 3166-1 alpha-2, or null. May differ from an address country

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

1

Find a company

Start with a name, website, ticker or registration number. Narrow the search with a country, exchange or authority.

2

Read the profile

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

3

Keep the ID

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

Coverage

8,035 company profiles.

Field coverage
Company profiles with recorded fields
Website or domain29
Listings7,835
Addresses41

10 countries: Canada, Germany, United Kingdom, Japan, Kenya, Cayman Islands, Netherlands, New Zealand, Taiwan, United States.

Snapshot: .

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_at73t5dva4tt",
      "name": "MICROSOFT CORP",
      "country": "US",
      "website": "https://www.microsoft.com/",
      "listings": [
        {
          "exchange": "Nasdaq",
          "symbol": "MSFT"
        }
      ],
      "address": {
        "type": "headquarters",
        "street": "ONE MICROSOFT WAY",
        "city": "REDMOND",
        "state": "WA",
        "postal": "98052-8300",
        "country": "US"
      },
      "match": {
        "field": "website",
        "value": "microsoft.com"
      }
    }
  ],
  "next": null
}

API referenceSDKsKeys and authentication

Every response field

Response fields

id
Stable company ID. Store it to retrieve the same profile later
name
Primary company name
country
Recorded company country as ISO 3166-1 alpha-2, or null. May differ from an address country
website
Recorded company website URL, or null when unknown
listings
Exchange and ticker pairs. An empty list does not establish private ownership
listings[].exchange
Recorded exchange or trading venue label; not a standardized MIC code
listings[].symbol
Ticker symbol on that exchange
address
One recorded address, or null. Prefers headquarters, then business, registered, mailing; first recorded within a type
address.type
Recorded address type: registered, headquarters, business or mailing
address.street
Street address, or null
address.city
City, or null
address.state
State code within the address country, using the same code format as the geography APIs, or null
address.postal
Postal code string, or null
address.country
ISO 3166-1 alpha-2 address country, or null

Deep fields

deep.aliases
Other company names
deep.jurisdiction
Recorded registration location as country and state codes, or null
deep.jurisdiction.country
Registration country as ISO 3166-1 alpha-2
deep.jurisdiction.state
State code within the registration country, such as WA, or null
deep.status
Recorded legal entity status; does not establish current business activity, website availability or listing status
deep.websites
Other associated websites, excluding the core website hostname. Includes all recorded domains when the core URL is unknown
deep.websites[].domain
Associated hostname, normalized to lowercase ASCII without a conventional www. prefix
deep.websites[].url
Recorded URL for this domain, or null; never inferred from a domain alone
deep.identifiers
Identifiers paired with their type and issuing authority
deep.identifiers[].type
Identifier type, such as cik, lei or registration
deep.identifiers[].value
Identifier string. Preserve leading zeros
deep.incorporated
Legal entity incorporation date as YYYY-MM-DD, or null
deep.addresses
Other recorded addresses, excluding the address returned in core, in recorded order
deep.addresses[].type
Recorded address type: registered, headquarters, business or mailing
deep.addresses[].street
Street address, or null
deep.addresses[].state
State code within the address country, with the same formatting as the core address, or null
deep.addresses[].postal
Postal code string, or null
deep.addresses[].country
ISO 3166-1 alpha-2 address country, or null
deep.industries
Industry classifications, each with its type and code
deep.industries[].type
Classification type, such as sic
deep.industries[].code
Industry code string
deep.industries[].name
Industry name, or null
deep.parent
Known parent company ID in this directory, or null

QUESTIONS

What can I search with?
A company name, website, stock ticker or registration identifier. Add a country, exchange or issuing authority to narrow a match. Registration numbers stay as strings, including their leading zeros.
What does deep add?
Add deep=true for the legal name and status, other names, registration jurisdiction, company identifiers, incorporation date, other associated websites, additional addresses, industry classifications and a recorded parent ID. It is optional and uses the same request pool.
What does status mean?
Deep reports the recorded legal entity status. It does not indicate trading activity or website availability.
Which address comes back?
The default includes one recorded address: headquarters first, then business, registered or mailing. If several share that type, the first recorded address is used. Its type and values stay as recorded. Deep adds the remaining addresses without repeating the default address.
Which companies are covered?
The current dataset has 8,035 company records. Open Coverage for the recorded website, listing and address counts. It is a selected dataset, not a registry of every business.
What do missing fields mean?
Null means a field is not recorded. The default website is null when no URL is recorded. Deep can still include associated domains with null URLs. An empty search means no match in this dataset. A missing listing does not establish private ownership.

Build with company data.

One key for Company and the rest of ParseAPI.

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