Skip to main content
POST
Company Preview

Credits and plans

PAYG is Pay-as-you-go. AYCE is All-you-can-eat. Company records are deduplicated to one search row per RBID_ORG. If you need company fields alongside individual people, contact records already include their available company data; requesting those fields does not add a separate company-row charge.

When to use Company Preview

Inspect a company list or retrieve an immediate batch of company records. For a downloadable file or a company audience selected through contact criteria, choose Company Export.

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 response

rows contains company objects. rowCount reports how many were returned; limit is the applied row cap. columns and columnLabels identify the returned fields. The list can be shorter than the limit. There is no pagination cursor or guaranteed order for ordinary requests.

Options and limits

Errors and retries

Correct unsupported fields or filters before retrying a 400 or 422 response. If a 429 response is returned, wait for Retry-After. Contact and company routes share the default 10 requests per second per user.

Next steps

Company Insights summarizes this audience. Company Enrich retrieves known company identifiers; Company Export creates a file.

Authorizations

X-Key
string
header
required

Body

application/json
filter
GroupNode · object | null

Company conditions only. Use Company Count and Export for company audiences selected by person or job criteria.

columns
string[] | null

Company fields to return. Omitted or empty uses company defaults; ["*"] expands to the company catalog.

limit
integer | null

Maximum rows requested; 1,000 default, clamped to 1 through 50,000.

includeSql
boolean
default:false
includeScores
boolean
default:false

Add available SmartSearch similarity scores; the response can report scoresOmitted.

reveal
string[] | null

Accepted for compatibility and ignored for company data; no contact email/mobile masking is applied.

Response

Successful Response

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