Reverse Contact Reverse Contact
Sign Up

Enrich company

6 min read

Get a company's profile from a domain.

POST
Sign up to try

Introduction

The Enrich Company endpoint returns a company’s profile from a domain.

This endpoint costs 2 credits, charged only when a company is found. Add +1 credit when fullProfile: true and a match is found. A not-found response (404) is always free, even with fullProfile: no credits are consumed.

Authorization

apikey string required
Your API key from the developer dashboard. Pass it via Authorization: Bearer YOUR_API_KEY header.

Request body

domain string required
Company domain to look up. A bare domain or a full URL works (e.g. acme.com or https://acme.com).
fullProfile boolean
Optional, defaults to false. When true and a match is found, returns the full profile (same fields as the corresponding fetch endpoint) for 1 extra credit.

Response structure

The company is returned nested under data.company.

Full profile

Set fullProfile to true to return the same company shape as /v2/fetch/companies when a match is found. The primary data.company then includes the full company profile owned by the fetch endpoint rather than the light enrich shape.

{
  "domain": "reversecontact.com",
  "fullProfile": true
}

The complete full-profile field reference is documented on the Company Profile endpoint. Note that the full shape uses the fetch naming: the company name is returned as companyName instead of name.

If the full profile cannot be assembled for the matched company, the response falls back to the light shape and only the base 2 credits are charged: the extra credit applies only when the full profile is actually delivered. To know which shape you received, check quotas.creditsConsumed (3 for full, 2 for light) or the presence of a full-profile field such as description.

success boolean
true if the request was processed successfully
error null
Always null on success
dataobject
The response payload (null on error responses)
Show child attributesHide child attributes
companyobject
The company profile
Show child attributesHide child attributes
id string
Internal identifier for the company
name string
Company name
publicId string
Universal name / slug (the /company/xxx part of the URL)
linkedinId string
Social identifier of the company
linkedinUrl string
Full Social company URL
industry string
Industry (e.g. "Software Development")
tagline string
Short company tagline
websiteUrl string
Official company website URL
employeesCount number
Exact number of employees
followersCount number
Number of followers on the company profile
companyUpdateDate string
When the record was last refreshed (ISO 8601)
employeeCountRangeobject
Estimated employee count range (null if unknown)
Show child attributesHide child attributes
start number
Lower bound of the employee range
end number
Upper bound of the employee range
locationobject
Geographic location (null if unknown)
Show child attributesHide child attributes
city string
City
country string
ISO country code (e.g. "FR")
quotasobject
Credits and rate limit usage after this request
Show child attributesHide child attributes
creditsConsumed number
Credits consumed by this request
workspaceobject
Workspace-level limits
Show child attributesHide child attributes
id string
Your workspace identifier
hasUnlimitedCredits boolean
Whether workspace credits are unlimited
allowDailyOvercost boolean
Whether the workspace may exceed its daily cap
creditsobject
Credit balance
Show child attributesHide child attributes
total number
Total credits in your plan
used number
Credits consumed so far
left number
Remaining credits
dailyLimitobject
Daily request limit (null if not configured)
Show child attributesHide child attributes
limit number
Maximum requests per day
used number
Requests made today
left number
Remaining requests today
nextReset string
When the daily window resets (ISO 8601)
minuteRateLimitobject
Per-minute rate limit
Show child attributesHide child attributes
limit number
Maximum requests per minute
used number
Requests made in the current minute
left number
Remaining requests in the current minute
nextReset string
When the minute window resets (ISO 8601)
keyobject
API key-level limits (null when request is from dashboard)
Show child attributesHide child attributes
id string
API key identifier
dailyLimitobject
Daily limit for this key (null if not configured)
Show child attributesHide child attributes
limit number
Maximum requests per day
used number
Requests made today
left number
Remaining requests today
nextReset string
When the daily window resets (ISO 8601)
minuteRateLimitobject
Minute rate limit for this key
Show child attributesHide child attributes
limit number
Maximum requests per minute
used number
Requests made in the current minute
left number
Remaining requests in the current minute
nextReset string
When the minute window resets (ISO 8601)
metadataobject
Request tracking information
Show child attributesHide child attributes
requestId string
Unique identifier for this request
executionTimeMs number
Total execution time in milliseconds

Previous

Enrich profile

Next

People search