Skip to main content
POST
Company Enrich

Credits and plans

PAYG is Pay-as-you-go. AYCE is All-you-can-eat.

When to use Company Enrich

Use a known list of domains, company LinkedIn URLs, or RBID_ORGs. Send the list in one JSON request; no file upload is required. This retrieves stored company data. It does not verify a person’s email address.

Example

Set REVENUEBASE_API_KEY to your API key.
Response captured from the local test API on October 13, 2026 using an AYCE account. Results can change as the dataset or account changes.

Read the matches

The request submits two domains and finds one match. On PAYG, it would hold 2 credits and settle 1 credit. The AYCE capture used 0 credits. The .invalid domain deliberately demonstrates an unmatched input; replace both domains with your own list.

Inputs and fields

The 10,000-identifier maximum is combined across all three lists, after normalization and deduplication. Supplying no valid identifiers or exceeding the cap returns 400.

Control the hold and final charge

PAYG reserves one credit per submitted array entry before normalization or deduplication. Have enough balance for that hold. The final charge is one credit per returned match; unused held credits are released. Unmatched inputs add no row charge. There is no SmartSearch fee. Deduplicate your input before sending it. The same company supplied as both a domain and a LinkedIn URL can produce two match entries and two row charges. Prefer one identifier per company when possible. Repeating a paid request can charge again.

Errors and next steps

A 402 response means the balance cannot cover the hold; reduce your input or add credits. Respect Retry-After for transient credit-service or rate-limit failures. Use Company Count to discover an audience by criteria, or Company Export for a file.

Authorizations

X-Key
string
header
required

Body

application/json

Company enrich keys: domains, company LinkedIn URLs and/or RBID_ORGs.

domains
string[]

Domains to look up. Combined maximum with LinkedIn URLs and RBIDs is 10,000 normalized distinct identifiers.

linkedinUrls
string[]

Company LinkedIn URLs, combined with the other identifier lists for the 10,000 cap.

rbidOrgs
string[]

Company IDs, combined with domains and LinkedIn URLs for the 10,000 cap.

columns
string[] | null

Company fields to return; request them explicitly. ["*"] expands to all company fields.

Response

Successful Response

The response is of type Response Company Enrich V1 Company Enrich Post · object.