Generate an Account Based List with the ABM API. Account-based lists include contact and company information for additional business people working at companies identified by their business domain.
Providing a business domain (and optional filter fields) the API will return a list of records that will include:

Title
Business Name
Domain
Email Address
Address
❗️
By submitting the API request, you agree to be charged based on the results from the generated list.
❗️ Expect long API Response Time (up to several minutes).
This API generates a list of records (up to several thousand) and will return them all at once in the response.
As such, some requests will take time to complete (up to several minutes).
Please ensure you manage time-outs accordingly.

Format

Here's the format to call the ABM API:

Output Type

Output type is what the user would like to obtain from the ABM API. There are two different output type available for this API; both can be used in the same call to obtain different data sets.
The below table provides a description of each output type.

Output Type	Value Type	Description
abm_email	Array	Will return email audience data in the output.
abm_online_audence	Array	Will return online audience data in the output.

Examples:

https://api.versium.com/v2/abm?output[]=abm_email&domain[]=versium.com

https://api.versium.com/v2/abm?output[]=abm_online_audience&domain[]=versium.com

https://api-stg.versium.com/v2/abm?output[]=abm_email&output[]=abm_online_audience&domain[]=versium.com

Inputs - what the API users to search

Inputs are information that the ABM API will use to search in the Versium REACH back end. The API will then match your inputs with data in the Versium Data store and return the matched business information as available.
The below table provides a description of the search parameter value that can be used.

Value	Description	Example
domain[]	A single business domain. Note: even if the input is an array, only one single domain will be accepted as input.	domain[]=versium.com

Optional Filter Parameters

Optional filter parameters will allow to configure the API to return only records that match the filters. The below table lists the optional filter parameters available.

Filter Parameter	Description	Possible Values	Example
rd_title_seniority[]	An array of seniority-related positions. Note*: values are case sensitive.	Owner/President C-Level VP/Sr. Executive Director Manager Non-Manager	rd_title_seniority[]=Director
rd_department[]	An array of company departments. Note*: values are case sensitive.	List too long - please see Department Values	rd_department[]=Creative
rd_role[]	An array of company roles. Note*: values are case sensitive.	List too long - please see Role Values	rd_role[]=Brokers
d_numemployees	The number of employees in the company. Value should be a string range in this format: min-max.	min: 0 max: 500000	d_numemployees=100-50000
d_salesvolume	The annual sales volume of a company. Value should be a string range in this format: min-max.	min: 0 max: 1,000,000,000,000	d_salesvolume=1000000-10000000000
d_state[]	An array of 2 letter US state abbreviations.	One or more of the 50 US state abbreviations.	d_state[]=AZ&d_state[]=WA
d_city_state[]	An array of US city and 2 letter US state combinations.	A US city with its state, separated by a comma.	d_city_state[]=Tucson,AZ&d_city_state[]=Seattle,WA
d_zip[]	An array of US zip5 codes.	One or more 5 digit US zip codes.	d_zip[]=98072&d_zip[]=98052&d_zip[]=98036

Optional Parameters

Optional Configuration Parameters are used to specify and configure how the ABM API will perform the search.

Optional Config. Param.	Value	Description	Usage
cfg_b2cloc	A Boolean that dictates whether any supplied location filters apply to a records business building location or the employees home location.	0 - business location 1 - employee home location	cfg_b2cloc=0 (default)
rcfg_domain_map	Return domains and parent companies in the result.	parent_dommap	rcfg_domain_map=parent_dommap
cfg_maxrecsperdomain	The maximum number of records to return for the input domain.	A numerical value	cfg_maxrecsperdomain=10

Response Headers

A successful response will return a Content-type response header, “Content-type: text/plain".

An error response will return a Content-type response header, “Content-Type: application/json“.

A unique query id will be returned in the response headers: “x-versium-query-id“.