Fetch company details
Retrieve a detailed profile for a known company, including identity, location, revenue, employee count, industry classification, and online presence. Optionally add family-tree, competitor, installed-technology, or logo data.
What you can retrieve
Company Details is best when you already have a Demandbase company ID from Company Search, record matching, or another B2B API workflow.
Understand the company
Retrieve the company name, description, type, operating status, tickers, websites, and social links.
Measure company scale
Return annual revenue, revenue currency, employee count, founding year, and site counts.
Understand the market
Review primary and secondary industries plus SIC, NAICS, and British SIC classifications.
Find the primary address
Return street, city, state, postal code, country, coordinates, and phone number.
Explore the company hierarchy
Add family-tree data to review related companies and acquisition relationships.
Add competitive and technology data
Optionally return competitors, installed technologies, and available company logos.
Common requests
Fetch the core company profile
Include the family tree
Include competitors
Include installed technologies
Include company logos
Include multiple related datasets
Quickstart
Replace COMPANY_ID with a company ID returned by Company Search or another B2B API workflow.
Send the request
Read the response
Request anatomy
Identify the company
Place the integer Demandbase company ID directly in the request path.
companyId | Required company identifier |
Control the response
Add related datasets, sort family-tree results, or select company fields.
fields | Related data to include |
sortBy | Family-tree result order |
companyFields | Comma-separated company fields |
Authenticate and choose a format
Send a valid bearer token and request JSON or XML.
Authorization | Bearer access token |
Accept | application/json or application/xml |
Response anatomy
The core response contains company profile data. Optional related datasets appear only when requested with fields.
Identity and status
companyId | Demandbase company ID |
companyName | Company name |
description | Company description |
companyType | Company type |
companyStatus | Operating status |
tickers | Ticker and exchange records |
Scale and classification
classification | Primary and secondary businesses |
revenue | Annual revenue in millions |
revenueCurrency | Revenue currency |
employeeCount | Employee count |
sic | SIC code and description |
naics | NAICS code and description |
Location and online presence
address | Primary address and coordinates |
phone | Company phone number |
websites | Company websites |
socialHandles | Social and blog URLs |
siteTypes | Known site types |
siteCount | Known site count |
Hierarchy and related companies
businessStructure | Company hierarchy type |
familyTree | Recursive company hierarchy |
acquisitions | Acquired-company records |
competitors | Competitor company records |
Technology, logos, and diversity
techUsed | Technology categories, subcategories, and products |
companyLogos | Available company-logo URLs |
diversity | Diversity attributes and certifications |
britishSics | British SIC codes and descriptions |
Important rules
Use an integer company ID
The companyId path value is required and must be an integer.
Use supported field values
Use familytree, competitors, installedtech, or logos.
Separate values with commas
Pass multiple fields values as one comma-separated query parameter.
Use the supported sort value
sortBy supports popularity for family-tree results.
Parameters and expansions
| Parameter | Location | Use it to | Example |
|---|---|---|---|
companyId | Path | Identify the company record to fetch. | 123456 |
fields | Query | Add one or more related datasets. | familytree,competitors |
sortBy | Query | Sort family-tree results. | popularity |
companyFields | Query | Select comma-separated company fields. | Comma-separated field names |
Related-data expansions
| Value | Returned as |
|---|---|
familytree | familyTree and related acquisition data |
competitors | competitors |
installedtech | techUsed |
logos | companyLogos |
Compact company objects
Family-tree, acquisition, and competitor results use compact company records.
companyId | Demandbase company ID |
name | Company name |
city | City |
state | State or province |
country | Country |
Requested data may be absent
Optional profile attributes and related datasets appear only when data is available for the selected company.
Common errors
| Status | Error | How to fix it |
|---|---|---|
400-103 |
companyId must be an integer. |
Use the numeric company ID returned by Company Search or another B2B API workflow. |
400-106 |
Invalid field name. | Use only documented values in fields and supported company-field names. |
401 |
Authentication failed. | Generate a valid token and send it in the Authorization: Bearer YOUR_ACCESS_TOKEN header. |
404-100 |
Invalid ID, record not found. | Confirm the company ID exists and is available to your API Key Set. |
Next steps
Search for additional companies, find contacts at the account, or retrieve recent company news.
Search companies → · Search contacts → · Company news →