Try the API

get

https://api.versium.com/v2/b2b2cAppend/

Each request must supply either li_url, or all four of first, last, city, and state. A LinkedIn URL is the most specific identity signal and produces the best match rates.

You are charged per match, not per request. A request that returns no results costs nothing. Default rates: business_email 2 credits, consumer_mobile 1, consumer_email 1 per address returned, consumer_address 1, crosswalk 1. The crosswalk charge applies once per record that returns any consumer contact point.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

output[]

array of strings

required

One or more outputs to append. Repeat the parameter once per output.

output[]*

Allowed:

li_url

string

LinkedIn profile URL. Satisfies the required-input rule on its own.

first

string

Person's first name. Required as part of the first/last/city/state combination.

last

string

Person's last name. Required as part of the first/last/city/state combination.

city

string

City name. Required as part of the first/last/city/state combination.

state

string

US state two-letter abbreviation. Required as part of the first/last/city/state combination.

zip

string

5-digit US ZIP code. Optional; improves match precision.

address

string

House/building number and street. Optional; used to refine the consumer email lookup.

country

string

Defaults to US

2 letter country code (only US is supported at present). Non-US records return zero results.

string

Known email address for the individual. Accepted but not currently used as an identity signal.

cfg_required

string

Return a result only if these outputs matched. Comma means AND, semicolon means OR. Must be a subset of the values sent in output[]. If the requirement is not satisfied, the whole response is a zero-result response and nothing is charged.

cfg_max_emails_b2c

integer

1 to 10

Defaults to 1

Maximum number of consumer email addresses to return. Consumer email is charged per address returned, so this parameter affects cost.

cfg_max_phones_b2c

integer

1 to 10

Defaults to 1

Maximum number of consumer mobile numbers to return. Consumer mobile is charged once per matched record regardless of how many numbers come back.

Responses

200Successful request. A request that runs but finds nothing is a zero-result response, not an error.

400The request is missing required parameters or is not structured correctly: no valid input combination, missing or invalid output[], a cfg_required value that is not a subset of output[], or a cfg_max_* value outside 1-10.

401Unauthenticated - the API key provided is invalid.

402Insufficient credits.

429Requests are exceeding the rate limit.

500Something broke on the server. The errors property may not be present, and the response object itself may not be returned.