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. PAYG has a shared allowance of 5,000 free preview rows per organization per UTC day across Contact View, Company View, and Company Preview. All members and API keys share it. Each returned row counts, including repeated previews; empty and failed queries do not. SmartSearch adds no credit charge on these free previews. The allowance resets at 00:00 UTC. AYCE has no daily preview allowance; per-request limits still apply. The response reports X-Credits-Charged: 0 and X-FreePreview-Remaining on PAYG. Near the daily boundary, only remaining rows are returned, with a warning. At exhaustion, 429 FREE_PREVIEW_CAP_REACHED is returned without rows or a credit charge. Wait until UTC midnight or explicitly choose a paid company export. 503 FREE_PREVIEW_UNAVAILABLE means the allowance could not be verified; retry later. Counts do not consume preview allowance.

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.