{"service":"company","title":"Company API","description":"Search 500 selected leading U.S. public-company issuers by name, official website, ticker or SEC CIK. Share classes are grouped by issuer. Optional Deep adds sourced company details.","endpoints":{"search":"GET /company?q={query}","website":"GET /company?domain={domain}","ticker":"GET /company?ticker={symbol}&exchange={exchange}","identifier":"GET /company?identifier={number}&authority={authority}","profile":"GET /company/id/{id}","coverage":"GET /company/directory/coverage"},"examples":{"name":"/company?q=Apple","website":"/company?domain=apple.com","ticker":"/company?ticker=AAPL&exchange=Nasdaq","identifier":"/company?identifier=0000320193&authority=SEC","country":"/company?q=Eaton&country=IE","profile":"/company/id/co_u5ntnpyvja2a","coverage":"/company/directory/coverage","deep":"/company/id/co_u5ntnpyvja2a?deep=true","country_discovery":"/company?country=US","industry_discovery":"/company?country=US&industry_type=sic&industry=7372"},"response":{"companies":"Search candidates with a usable core profile and match: { field, value }. Domain matches use field: website when the recorded core URL has that hostname, or domains for an associated hostname available in Deep. Ticker matches also carry exchange; identifier matches carry type and authority. An empty array means no match in this directory edition. Filter-only discovery returns match: { field: filters, value: null } in stable company-ID order.","next":"Opaque cursor for the next page, or null. Reuse the same selector, filters and limit; deep may change without restarting pagination.","id":"Stable company ID: co_ followed by 12 lowercase characters using the same unambiguous alphabet as City IDs","name":"Source-supported primary display name","country":"Recorded incorporation country as ISO 3166-1 alpha-2, or null. It does not establish headquarters or operations and may differ from address.country.","website":"Recorded company website URL, or null when no single URL is recorded. Other known website hostnames appear in deep.domains; a domain alone does not establish a website URL.","listings":"Listings as { exchange, symbol }. Exchange is a recorded exchange or market label, not a standardized MIC code. A company may have multiple listings; no primary symbol is inferred and an empty array does not establish private status.","address":"One recorded address as { type, street, city, state, postal, country }, or null. Prefer headquarters, then business, then registered, then mailing; choose the first recorded address within that type. State uses ParseAPI's local subdivision code, such as WA with country US. A conflicting country-qualified state becomes null; other components stay recorded, with unknown components null. Other recorded addresses appear in deep.addresses.","deep":"Optional business details, included only when deep=true. Search puts the deep bag on each company; lookup uses the same profile shape."},"parameters":{"q":"Name search. Supply at most one of q, domain, ticker or identifier. Without a selector, supply country or the complete industry_type/industry pair. Exact names precede prefixes and substrings.","domain":"Exact public website hostname or HTTP(S) website URL. Hostnames are normalized; subdomains are not automatically their parent company.","ticker":"Exact ticker symbol, matched without case sensitivity","identifier":"SEC CIK as a string, with or without its leading zeros. authority=sec is optional for a numeric CIK.","country":"Recorded incorporation country, not the exchange location or headquarters. Can narrow a selector or discover profiles.","exchange":"Optional recorded exchange or market label filter, supported only with ticker","authority":"Optional identifier authority filter, supported only with identifier","limit":"Search page size from 1 to 50; defaults to 20","cursor":"The next cursor from the same selector, filters, limit and content version. Changing deep does not invalidate it.","id":"Company ID returned by a search, for GET /company/id/{id}","pretty":"?pretty=true formats the JSON response","deep":"true or false for search and profile requests; defaults to false. Adds optional details on every plan within the same pooled request, with no separate charge. False or omission leaves out the deep bag.","industry_type":"Industry namespace, required together with industry. Currently exactly sic (lowercase); no other classification system is inferred.","industry":"Exact four-ASCII-digit SIC code as a string, required with industry_type=sic. Matches a recorded public industry classification; preserves leading zeros. No prefix, hierarchy or website-description inference. May stand alone with its type or narrow any selector and country."},"coverage":{"scope":"us_public_top500: a fixed cohort of 500 issuers, not complete U.S. business coverage.","label":"Directory label","description":"What the coverage counts do and do not establish","snapshot_at":"Latest source observation time across the loaded cohort, in UTC; not the update time of every company.","companies":"Exact number of loaded company profiles","countries":"Sorted ISO2 countries known in the loaded profiles","with_website":"Profiles with at least one recorded website hostname","with_listings":"Profiles with at least one exchange listing","with_address":"Profiles with at least one address"},"errors":{"400":"Invalid search options, company ID or cursor","404":"A well-formed company ID is absent from the loaded directory catalog","503":"Company lookup failed. Try again later."},"tips":["Directory search, profiles and coverage require an API key and API version 2.0.0, using the plan's pooled request allowance.","Search returns usable core profiles; selecting a company does not require another lookup. Search never selects an ambiguous company automatically.","Names, domains, tickers and identifiers are not globally unique. Identifier matches retain their type and authority even when deep is omitted.","Registered, headquarters, business and mailing addresses retain their different meanings. A location is not automatically a separate legal company.","GET /company/directory/coverage describes the directory edition. A missing result does not prove that a business does not exist.","Unknown fields remain null and unrecorded collections remain empty. Employee counts, revenue and private-company status are not inferred.","Deep status is a recorded legal-entity fact, not an independent check that a company is currently operating. The edition date does not establish when each fact last changed.","Browse by incorporation country or four-digit SIC industry. These filters describe the selected public-company cohort; employee counts are not search filters."],"deep":{"legal_name":"Registered legal name, or null when unknown","aliases":"Alternative or former names","jurisdiction":"Recorded jurisdiction where the company is registered as { country, state }, or null. Country is ISO2 and state uses ParseAPI's local subdivision code, such as { country: US, state: WA }; country-only jurisdictions have state: null. This is separate from the location of any address and is never inferred from it.","status":"Recorded legal-entity status, or null. This does not establish that the business is currently operating, listed, solvent or accepting customers.","domains":"Other recorded website hostnames as { domain, url }, excluding the normalized hostname of the core website. Retains recorded order; url is null when only a hostname is known, without inventing an HTTPS URL. When website is null, all known hostnames remain here. Multiple companies can share a domain.","identifiers":"Business identifiers as { type, authority, value }. Leading zeros are preserved; a number is scoped to its authority.","incorporated":"Recorded incorporation date as YYYY-MM-DD, or null","addresses":"All other recorded addresses as { type, street, city, state, postal, country }, excluding the core address and retaining recorded order. They use the same state-code normalization as address; an empty array means no additional address is recorded.","industries":"Business classifications as { type, code, name }. Unknown names remain null.","parent":"Known parent company ID in this directory, or null","description":"Business summary based on company filings, or null when unavailable.","logo":"Recorded HTTP(S) logo URL, or null. This is a reference to the asset, not a grant of permission to reuse it.","social_profiles":"Recorded social profiles as { platform, url, handle }. URL is HTTP(S); platform and handle are null when unknown. An empty array means none are recorded.","founded":"Reported business founding date as { value, precision }, or null. Precision is year, month or day, with value formatted as YYYY, YYYY-MM or YYYY-MM-DD respectively. Separate from legal incorporation; missing date components are not invented.","employees":"Reported workforce count, dated as_of, with scope, method, approximate and basis (headcount, full_time or full_time_equivalent). Unknown observations remain null.","sources":"Attribution for returned selected details as { type, url, fields, observed_at, updated_at }. Type website supplies description, logo, social_profiles, founded, phone_numbers or email_addresses; sec_filing supplies description, founded, employees, phone_numbers or email_addresses. Fields lists only the returned facts supplied by that source. Observed_at is the source-read time; updated_at is the reported update timestamp or null. These dates do not replace employees.as_of. The five descriptive fields are an additive group that older directory editions may omit. Unavailable scalars are null and selected collections may be empty.","phone_numbers":"Optional selected public business phone records as { number, type }; type is the source-reported purpose or null. Omitted when none are selected. This does not verify reachability or ownership.","email_addresses":"Optional selected public business email records as { address, type }; type is the source-reported purpose or null. Omitted when none are selected. This does not verify delivery or ownership."}}