Partner with ReachStream using Reach API

The ReachStream platform provides an advanced search capability focused on people, companies, and their relationships. The Reach API allows you to integrate ReachStream functionality and data into your developer ecosystem, including your CRM (Customer Relationship Management), MA tool (Marketing Automation), or other data system (cloud-based tools).

The contact and company data available via the Reach API is the same data accessible within the ReachStream platform. This means the API’s data undergo the same scrutiny of accuracy, standardization, and verification that our customers are used to on the ReachStream online platform. As usual, the data we serve is meticulously handcrafted and verified, up to date and accurate information.

The Reach API is available as REST web service calls via HTTP requests. A developer portal is hand deployed and customized for each customer. The developer portal showcases the APIs available for use, the schema (models) for each API, documentation, the ability to ‘Try out’ APIs, and much more.

Contact us now to get started on integrating with highly accurate contact leads to take your business to the next level.

Reach API Overview-

The Reach API is a set of REST oriented web services that provide access to information via HTTP requests. Our API has predictable resource-oriented URLs, accepts standard headers, accepts and returns JSON responses, and uses standard HTTP response codes, authentication, and verbs.

The Reach API also describes it’s JSON payloads using well-formed schema to provide a deterministic programming experience.

Reach API requests or calls are made through properly formed URLs. The URLs are created manually or programmatically. There are several elements to the URL that need to be composed correctly to request to succeed and return data. This article’s remainder provides an overview of the Reach API, onboarding, usage, and other details to get started.

Subscribe to Reach API announce mailing list for updates.

Developer Portal

The developer portal is hand deployed for each customer and provides the foundation for using the Reach API. In the developer portal, developers will be able to:

  1. Log in using their secure credentials to view all available APIs.Read the developer documentation for each API.
  2.  View the schema (models) for each API.
  3. ‘Try out’ each API interactively to test and grasp the usage of each API.
  4. Access their developer API key to authenticate each request.
  5. Observe the remaining quota for each API. 10. Offer feedback and ask support questions.

Types of Reach APIs

We offer three categories of APIs. By leveraging these different types, you’ll be able to use the Reach API platform to discover new, accurate, and promising marketing leads.

The three categories are as follows:

Contact ReachID APIs

These APIs operate exclusively on the “Contact ReadID” as a parameter in the request. Therefore, they operate within the context of a single contact. Use this API when you have a Contact ReadID, and you’d like to see if we have information for this contact.

Contact ReachID Query

Given a Contact ReachID, this API will return what fields are available to retrieve via a data call. The data field availability will be shown, but the data will be masked.

QUERY TEMPLATE

curl -X GET “https://ffvwdxqgx6.execute-api.us-west-2.amazonaws.com/Kenneth-Premium?reach_id=123”
-H “accept: application/json”
-H “x-api-key: 5sFxn2kilW2MXIvxZVr4p2b5EOANYdMb2jptcVcb”
curl -X GET “https://ffvwdxqgx6.execute-api.us-west-2.amazonaws.com/Kenneth-Premium?reach_id=123”
-H “accept: application/json”
-H “x-api-key: 5sFxn2kilW2MXIvxZVr4p2b5EOANYdMb2jptcVcb”

RESPONSE TEMPLATE

{
“results”: [
{
“contact_addresses”: {
“address_type”: null,
“city_name”: null,
“country_id”: null,
“country_name”: null,
“region”: null,
“state_name”: null,
“street_name”: null,
“zip_code”: null
},
“contact_company”: {
“acquisition_amount”: null,
“acquisition_company_name”: null,
“acquisition_date”: null,
“annual_revenue_amount”: null,
“buzz_words”: [],
“company_addresses”: {
“address_type”: null,
“city_name”: “Available”,
“country_id”: “Available”,
“country_name”: “Available”,
“region”: null,
“state_name”: “Available”,
“street_name”: “Available”,
“zip_code”: “Available”
},
“company_emails”: [],
“company_name”: “Available”,
“company_phones”: [
{
“is_active”: true,
“phone”: “6********”,
“phone_ext”: null,
“phone_type”: null
},
{
“is_active”: true,
“phone”: “6********”,
“phone_ext”: null,
“phone_type”: null
},
{
“is_active”: true,
“phone”: “6********”,
“phone_ext”: null,
“phone_type”: null
}
],
“company_social_media”: [],
“company_type”: null,
“company_type_id”: null,
“created_at”: “Available”,
“created_by”: “Available”,
“description”: null,
“employee_size”: null,
“fax”: null,
“fiscal_year_end_month”: null,
“founded_year”: null,
“id”: “Available”,
“industry_categories_list”: [
“Available”
],
“investment_amount”: null,
“investment_company_name”: null,
“investment_description”: null,
“investment_end_date”: null,
“investment_round”: null,
“investment_started_date”: null,
“naics_code”: null,
“projected_revenue_amount”: null,
“projected_revenue_period_in_years”: null,
“projected_revenue_peroid_in_years”: null,
“public_status”: null,
“sic_code”: null,
“tech_keywords”: [],
“updated_at”: null,
“updated_by”: null,
“website”: “Available”
},
“contact_emails”: [
{
“email”: “******@pikevillehospital.org”,
“email_verified_status”: TRUE
}
],
“contact_job”: {
“company_id”: “Available”,
“contact_id”: “Available”,
“created_at”: “Available”,
“created_by”: “Available”,
“end_date”: null,
“id”: “Available”,
“job_dept”: null,
“job_function”: null,
“job_role”: null,
“job_title”: null,
“job_title_level”: null,
“reporting_authority”: null,
“start_date”: null,
“updated_at”: null,
“updated_by”: null
},
“contact_name”: “Available”,
“contact_phones”: [],
“contact_social_media”: [],
“created_at”: “Available”,
“created_by”: “Available”,
“dob”: null,
“first_name”: “Available”,
“gender”: null,
“last_name”: “Available”,
“midddle_name”: null,
“middle_name”: “Available”,
“reach_id”: 20,
“suffix”: null,
“updated_at”: null,
“updated_by”: null
}
],
“totalResultsCount”: 1

}
}

{
“results”: [
{
“contact_addresses”: {
“address_type”: null,
“city_name”: null,
“country_id”: null,
“country_name”: null,
“region”: null,
“state_name”: null,
“street_name”: null,
“zip_code”: null
},
“contact_company”: {
“acquisition_amount”: null,
“acquisition_company_name”: null,
“acquisition_date”: null,
“annual_revenue_amount”: null,
“buzz_words”: [],
“company_addresses”: {
“address_type”: null,
“city_name”: “Available”,
“country_id”: “Available”,
“country_name”: “Available”,
“region”: null,
“state_name”: “Available”,
“street_name”: “Available”,
“zip_code”: “Available”
},
“company_emails”: [],
“company_name”: “Available”,
“company_phones”: [
{
“is_active”: true,
“phone”: “6********”,
“phone_ext”: null,
“phone_type”: null
},
{
“is_active”: true,
“phone”: “6********”,
“phone_ext”: null,
“phone_type”: null
},
{
“is_active”: true,
“phone”: “6********”,
“phone_ext”: null,
“phone_type”: null
}
],
“company_social_media”: [],
“company_type”: null,
“company_type_id”: null,
“created_at”: “Available”,
“created_by”: “Available”,
“description”: null,
“employee_size”: null,
“fax”: null,
“fiscal_year_end_month”: null,
“founded_year”: null,
“id”: “Available”,
“industry_categories_list”: [
“Available”
],
“investment_amount”: null,
“investment_company_name”: null,
“investment_description”: null,
“investment_end_date”: null,
“investment_round”: null,
“investment_started_date”: null,
“naics_code”: null,
“projected_revenue_amount”: null,
“projected_revenue_period_in_years”: null,
“projected_revenue_peroid_in_years”: null,
“public_status”: null,
“sic_code”: null,
“tech_keywords”: [],
“updated_at”: null,
“updated_by”: null,
“website”: “Available”
},
“contact_emails”: [
{
“email”: “******@pikevillehospital.org”,
“email_verified_status”: TRUE
}
],
“contact_job”: {
“company_id”: “Available”,
“contact_id”: “Available”,
“created_at”: “Available”,
“created_by”: “Available”,
“end_date”: null,
“id”: “Available”,
“job_dept”: null,
“job_function”: null,
“job_role”: null,
“job_title”: null,
“job_title_level”: null,
“reporting_authority”: null,
“start_date”: null,
“updated_at”: null,
“updated_by”: null
},
“contact_name”: “Available”,
“contact_phones”: [],
“contact_social_media”: [],
“created_at”: “Available”,
“created_by”: “Available”,
“dob”: null,
“first_name”: “Available”,
“gender”: null,
“last_name”: “Available”,
“midddle_name”: null,
“middle_name”: “Available”,
“reach_id”: 20,
“suffix”: null,
“updated_at”: null,
“updated_by”: null
}
],
“totalResultsCount”: 1

}

}

Contact ReachID Data

Given a Contact ReachID, this API will return all data fields associated with that Contact ReachID. The data will be completely unmasked, accessible, and ready for consumption.

QUERY TEMPLATE

curl -X GET “https://ffvwdxqgx6.execute-api.us-west-2.amazonaws.com/Kenneth-Premium?reach_id=123”
-H “accept: application/json”
-H “x-api-key: 5sFxn2kilW2MXIvxZVr4p2b5EOANYdMb2jptcVcb”
curl -X GET “https://ffvwdxqgx6.execute-api.us-west-2.amazonaws.com/Kenneth-Premium?reach_id=123”
-H “accept: application/json”
-H “x-api-key: 5sFxn2kilW2MXIvxZVr4p2b5EOANYdMb2jptcVcb”

RESPONSE TEMPLATE

{
“results”:[
{
“contact_addresses”:{
“address_type”:null,
“city_name”:null,
“country_id”:null,
“country_name”:null,
“region”:null,
“state_name”:null,
“street_name”:null,
“zip_code”:null
},
“contact_company”:{
“acquisition_amount”:null,
“acquisition_company_name”:null,
“acquisition_date”:null,
      “annual_revenue_amount”:null,
“buzz_words”:[],
“company_addresses”:{
“address_type”:null,
“city_name”:“huntington park”,
“country_id”:229,
“country_name”:“United States”,
“region”:null,
“state_name”:“ca”,
“street_name”:“2675 e slauson ave”,
“zip_code”:“90255-2926”
},
“company_emails”:[],
“company_name”:“Verity Medical Foundation”,
“company_phones”:[
{
“is_active”:true,
“phone”:“650-991-5880”,
“phone_ext”:null,
“phone_type”:null
},
{
“is_active”:true,
“phone”:“408-278-3000”,
“phone_ext”:null,
“phone_type”:null
},
{
“is_active”:true,
“phone”:“213-484-5543”,
“phone_ext”:null,
“phone_type”:null
},
{
“is_active”:true,
“phone”:“323-589-6681”,
“phone_ext”:null,
“phone_type”:null
}
],
“company_social_media”:[],
“company_type”:null,
“company_type_id”:null,
“created_at”:“2020-06-16T10:06:31”,
“created_by”:1,
“description”:null,
“employee_size”:null,
“fax”:null,
“fiscal_year_end_month”:null,
“founded_year”:null,
“id”:15,
“industry_categories_list”:[
“Healthcare”
],
“investment_amount”:null,
“investment_company_name”:null,
“investment_description”:null,
“investment_end_date”:null,
“investment_round”:null,
“investment_started_date”:null,
“naics_code”:null,
“projected_revenue_amount”:null,
“projected_revenue_period_in_years”:null,
“projected_revenue_peroid_in_years”:null,
“public_status”:null,
“sic_code”:null,
“tech_keywords”:[],
“updated_at”:null,
“updated_by”:null,
“website”:“www.verity.org”
},
“contact_emails”:[
{
“email”:“bagrawal@verity.org”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:15,
“contact_id”:15,
“created_at”:“2020-06-16T10:06:31”,
“created_by”:1,
“end_date”:null,
“id”:15,
“job_dept”:null,
“job_function”:null,
“job_role”:null,
“job_title”:null,
“job_title_level”:null,
“reporting_authority”:null,
“start_date”:null,
“updated_at”:null,
“updated_by”:null
},
“contact_name”:“Brajesh Kumar Agrawal”,
“contact_phones”:[],
“contact_social_media”:[],
“created_at”:“2020-06-16T10:06:31”,
“created_by”:1,
“dob”:null,
“first_name”:“Brajesh”,
“gender”:null,
“last_name”:“Agrawal”,
“midddle_name”:null,
“middle_name”:“Kumar”,
“reach_id”:15,
“suffix”:null,
“updated_at”:null,
“updated_by”:null
}
],
“totalResultsCount”:1
}
{
“results”:[
{
“contact_addresses”:{
“address_type”:null,
“city_name”:null,
“country_id”:null,
“country_name”:null,
“region”:null,
“state_name”:null,
“street_name”:null,
“zip_code”:null
},
“contact_company”:{
“acquisition_amount”:null,
“acquisition_company_name”:null,
“acquisition_date”:null,
      “annual_revenue_amount”:null,
“buzz_words”:[],
“company_addresses”:{
“address_type”:null,
“city_name”:“huntington park”,
“country_id”:229,
“country_name”:“United States”,
“region”:null,
“state_name”:“ca”,
“street_name”:“2675 e slauson ave”,
“zip_code”:“90255-2926”
},
“company_emails”:[],
“company_name”:“Verity Medical Foundation”,
“company_phones”:[
{
“is_active”:true,
“phone”:“650-991-5880”,
“phone_ext”:null,
“phone_type”:null
},
{
“is_active”:true,
“phone”:“408-278-3000”,
“phone_ext”:null,
“phone_type”:null
},
{
“is_active”:true,
“phone”:“213-484-5543”,
“phone_ext”:null,
“phone_type”:null
},
{
“is_active”:true,
“phone”:“323-589-6681”,
“phone_ext”:null,
“phone_type”:null
}
],
“company_social_media”:[],
“company_type”:null,
“company_type_id”:null,
“created_at”:“2020-06-16T10:06:31”,
“created_by”:1,
“description”:null,
“employee_size”:null,
“fax”:null,
“fiscal_year_end_month”:null,
“founded_year”:null,
“id”:15,
“industry_categories_list”:[
“Healthcare”
],
“investment_amount”:null,
“investment_company_name”:null,
“investment_description”:null,
“investment_end_date”:null,
“investment_round”:null,
“investment_started_date”:null,
“naics_code”:null,
“projected_revenue_amount”:null,
“projected_revenue_period_in_years”:null,
“projected_revenue_peroid_in_years”:null,
“public_status”:null,
“sic_code”:null,
“tech_keywords”:[],
“updated_at”:null,
“updated_by”:null,
“website”:“www.verity.org”
},
“contact_emails”:[
{
“email”:“bagrawal@verity.org”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:15,
“contact_id”:15,
“created_at”:“2020-06-16T10:06:31”,
“created_by”:1,
“end_date”:null,
“id”:15,
“job_dept”:null,
“job_function”:null,
“job_role”:null,
“job_title”:null,
“job_title_level”:null,
“reporting_authority”:null,
“start_date”:null,
“updated_at”:null,
“updated_by”:null
},
“contact_name”:“Brajesh Kumar Agrawal”,
“contact_phones”:[],
“contact_social_media”:[],
“created_at”:“2020-06-16T10:06:31”,
“created_by”:1,
“dob”:null,
“first_name”:“Brajesh”,
“gender”:null,
“last_name”:“Agrawal”,
“midddle_name”:null,
“middle_name”:“Kumar”,
“reach_id”:15,
“suffix”:null,
“updated_at”:null,
“updated_by”:null
}
],
“totalResultsCount”:1
}

Contact APIs

These APIs operate using filters that target a specific contact instead of a segment. For example, you may be looking for a contact with a specific email address or a job title. They take in a series of these contact-oriented filters to narrow down potential contact.

Contact API Query

Given a set of filter(s) that are targeted towards an individual, this API will perform a search and return matching contact. Subsequently, a developer can use the “contact_reach_id” from each of the returned contact and perform a “Contact ReachID Data” API call to get the unmasked data for that contact.

Parameter Description
first_names
A list of first names to query against. Note that this search attempts to perform a fuzzy match to find similar names. - String
last_names
A list of last names to query against. Note that this search attempts to perform a fuzzy match to find similar names. - String
job_titles
A list of job titles to query against. Note that this is NOT a fuzzy match and titles here must be matched explicitly against a contact's job title for a match to occur in the results. The list of possible titles that may be used here (the taxonomy of job titles) will be hand delivered via the support team as this is not public information. - String
emails
A list of email addresses to query against. Note that this is NOT a fuzzy match - only exact matches will yield results. - String
phones
A list of phone numbers to query against. Note that this is a fuzzy match - especially since phone numbers may have parenthesis and area codes. We rank results based on closest matching phone numbers. - String
company_names
A list of company names to query against. Note that this is a fuzzy match - especially since company names may have suffixes. - String
pageNumber

minimum: 1

Page number to retrieve. Note that results will never exceed 10,000 and there are 20 results per page. This means that this number must never be less then 0 or greater then 500 as 500*20=10,000 - Integer

QUERY TEMPLATE

{

“first_names”: [
“string”
],

  “last_names”: [
“string”
],

  “job_titles”: [
“string”
],

  “emails”: [
“string”
],

  “phones”: [
“string”
],

  “company_names”: [
“string”
],

  “pageNumber”: 0
}
{

“first_names”: [
“string”
],

  “last_names”: [
“string”
],

  “job_titles”: [
“string”
],

  “emails”: [
“string”
],

  “phones”: [
“string”
],

  “company_names”: [
“string”
],

  “pageNumber”: 0
}

RESPONSE TEMPLATE

{

“results”:[
{
“contact_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“contact_company”:{
“acquisition_amount”:“string”,
“acquisition_company_name”:“string”,
“acquisition_date”:“string”,
“annual_revenue_amount”:“string”,
“buzz_words”:[
“string”
],
“company_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“company_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“company_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“company_name”:“string”,
“company_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“company_type”:“string”,
“company_type_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“description”:“string”,
“employee_size”:“string”,
“fax”:“string”,
“fiscal_year_end_month”:“string”,
“founded_year”:“string”,
“id”:“string”,
“industry_categories_list”:[
“string”
],
“investment_amount”:“string”,
“investment_company_name”:“string”,
“investment_description”:“string”,
“investment_end_date”:“string”,
“investment_round”:“string”,
“investment_started_date”:“string”,
“naics_code”:“string”,
“projected_revenue_amount”:“string”,
“projected_revenue_period_in_years”:“string”,
“public_status”:“string”,
“sic_code”:“string”,
“tech_keywords”:[
“string”
],
“updated_at”:“string”,
“updated_by”:“string”,
“website”:“string”
},
“contact_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:“string”,
“contact_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“end_date”:“string”,
“id”:“string”,
“job_dept”:“string”,
“job_function”:“string”,
“job_role”:“string”,
“job_title”:“string”,
“job_title_level”:“string”,
“reporting_authority”:“string”,
“start_date”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
},
“contact_name”:“string”,
“contact_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“contact_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“created_at”:“string”,
“created_by”:“string”,
“dob”:“string”,
“first_name”:“string”,
“gender”:“string”,
“last_name”:“string”,
“midddle_name”:“string”,
“middle_name”:“string”,
“reach_id”:0,
“suffix”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
}
],
“totalResultsCount”:0
}
{

“results”:[
{
“contact_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“contact_company”:{
“acquisition_amount”:“string”,
“acquisition_company_name”:“string”,
“acquisition_date”:“string”,
“annual_revenue_amount”:“string”,
“buzz_words”:[
“string”
],
“company_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“company_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“company_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“company_name”:“string”,
“company_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“company_type”:“string”,
“company_type_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“description”:“string”,
“employee_size”:“string”,
“fax”:“string”,
“fiscal_year_end_month”:“string”,
“founded_year”:“string”,
“id”:“string”,
“industry_categories_list”:[
“string”
],
“investment_amount”:“string”,
“investment_company_name”:“string”,
“investment_description”:“string”,
“investment_end_date”:“string”,
“investment_round”:“string”,
“investment_started_date”:“string”,
“naics_code”:“string”,
“projected_revenue_amount”:“string”,
“projected_revenue_period_in_years”:“string”,
“public_status”:“string”,
“sic_code”:“string”,
“tech_keywords”:[
“string”
],
“updated_at”:“string”,
“updated_by”:“string”,
“website”:“string”
},
“contact_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:“string”,
“contact_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“end_date”:“string”,
“id”:“string”,
“job_dept”:“string”,
“job_function”:“string”,
“job_role”:“string”,
“job_title”:“string”,
“job_title_level”:“string”,
“reporting_authority”:“string”,
“start_date”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
},
“contact_name”:“string”,
“contact_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“contact_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“created_at”:“string”,
“created_by”:“string”,
“dob”:“string”,
“first_name”:“string”,
“gender”:“string”,
“last_name”:“string”,
“midddle_name”:“string”,
“middle_name”:“string”,
“reach_id”:0,
“suffix”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
}
],
“totalResultsCount”:0
}

Contact API Data

Given a set of filter(s) that are targeted towards an individual, this API will perform a search and return matching contact. The data that is returned will be completely unmasked and ready for consumption.

QUERY TEMPLATE

{

“first_names”: [
“string”
],

  “last_names”: [
“string”
],

  “job_titles”: [
“string”
],

  “emails”: [
“string”
],

  “phones”: [
“string”
],

  “company_names”: [
“string”
],

  “pageNumber”: 0
}
{

“first_names”: [
“string”
],

  “last_names”: [
“string”
],

  “job_titles”: [
“string”
],

  “emails”: [
“string”
],

  “phones”: [
“string”
],

  “company_names”: [
“string”
],

  “pageNumber”: 0
}

RESPONSE TEMPLATE

{

“results”:[
{
“contact_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“contact_company”:{
“acquisition_amount”:“string”,
“acquisition_company_name”:“string”,
“acquisition_date”:“string”,
“annual_revenue_amount”:“string”,
“buzz_words”:[
“string”
],
“company_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“company_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“company_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“company_name”:“string”,
“company_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“company_type”:“string”,
“company_type_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“description”:“string”,
“employee_size”:“string”,
“fax”:“string”,
“fiscal_year_end_month”:“string”,
“founded_year”:“string”,
“id”:“string”,
“industry_categories_list”:[
“string”
],
“investment_amount”:“string”,
“investment_company_name”:“string”,
“investment_description”:“string”,
“investment_end_date”:“string”,
“investment_round”:“string”,
“investment_started_date”:“string”,
“naics_code”:“string”,
“projected_revenue_amount”:“string”,
“projected_revenue_period_in_years”:“string”,
“public_status”:“string”,
“sic_code”:“string”,
“tech_keywords”:[
“string”
],
“updated_at”:“string”,
“updated_by”:“string”,
“website”:“string”
},
“contact_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:“string”,
“contact_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“end_date”:“string”,
“id”:“string”,
“job_dept”:“string”,
“job_function”:“string”,
“job_role”:“string”,
“job_title”:“string”,
“job_title_level”:“string”,
“reporting_authority”:“string”,
“start_date”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
},
“contact_name”:“string”,
“contact_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“contact_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“created_at”:“string”,
“created_by”:“string”,
“dob”:“string”,
“first_name”:“string”,
“gender”:“string”,
“last_name”:“string”,
“midddle_name”:“string”,
“middle_name”:“string”,
“reach_id”:0,
“suffix”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
}
],
“totalResultsCount”:0
}
{

“results”:[
{
“contact_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“contact_company”:{
“acquisition_amount”:“string”,
“acquisition_company_name”:“string”,
“acquisition_date”:“string”,
“annual_revenue_amount”:“string”,
“buzz_words”:[
“string”
],
“company_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“company_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“company_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“company_name”:“string”,
“company_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“company_type”:“string”,
“company_type_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“description”:“string”,
“employee_size”:“string”,
“fax”:“string”,
“fiscal_year_end_month”:“string”,
“founded_year”:“string”,
“id”:“string”,
“industry_categories_list”:[
“string”
],
“investment_amount”:“string”,
“investment_company_name”:“string”,
“investment_description”:“string”,
“investment_end_date”:“string”,
“investment_round”:“string”,
“investment_started_date”:“string”,
“naics_code”:“string”,
“projected_revenue_amount”:“string”,
“projected_revenue_period_in_years”:“string”,
“public_status”:“string”,
“sic_code”:“string”,
“tech_keywords”:[
“string”
],
“updated_at”:“string”,
“updated_by”:“string”,
“website”:“string”
},
“contact_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:“string”,
“contact_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“end_date”:“string”,
“id”:“string”,
“job_dept”:“string”,
“job_function”:“string”,
“job_role”:“string”,
“job_title”:“string”,
“job_title_level”:“string”,
“reporting_authority”:“string”,
“start_date”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
},
“contact_name”:“string”,
“contact_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“contact_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“created_at”:“string”,
“created_by”:“string”,
“dob”:“string”,
“first_name”:“string”,
“gender”:“string”,
“last_name”:“string”,
“midddle_name”:“string”,
“middle_name”:“string”,
“reach_id”:0,
“suffix”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
}
],
“totalResultsCount”:0
}

Segment APIs

These APIs operate on a per-segment basis. They take in a series of segment oriented filters to narrow down potential contact.

Segment API Query

Given a set of filter(s) that are targeted towards a segment, this API will perform a search and return matching contacts. Subsequently, a developer can use the “contact_reach_id” from each of the returned contacts and perform a “Contact ReachID Data” API call to get the unmasked data for that contact.

Parameter Description
regions
A list of regions to query against. Note that this is NOT a fuzzy match and regions here must be matched explicitly against a company's region for a match to occur in the results. The list of possible regions that may be used here (the taxonomy of regions) will be hand delivered via the support team as this is not public information. - String
countries
A list of countries to query against. Note that this is NOT a fuzzy match and countries here must be matched explicitly against a company's country for a match to occur in the results. The list of possible countries that may be used here (the taxonomy of countries) will be hand delivered via the support team as this is not public information. - String
states
A list of states (in any country) to query against. Note that this is NOT a fuzzy match and states here must be matched explicitly against a company's state (in one of their addresses) for a match to occur in the results. The list of possible states that may be used here (the taxonomy of states) will be hand delivered via the support team as this is not public information. - String
cities
A list of cities (in any country) to query against. Note that this is a fuzzy match and cities here can be hand crafted freely. Since this is a fuzzy match we do our best to find records that have companies located in cities closely matching the provided cities in this filter. - String
jobTitles
A list of job titles to query against. Note that this is NOT a fuzzy match and titles here must be matched explicitly against a contact's job title for a match to occur in the results. The list of possible titles that may be used here (the taxonomy of job titles) will be hand delivered via the support team as this is not public information. - String
sicCodes
A list of sic codes to query against. Note that this is NOT a fuzzy match and sic codes here must be matched explicitly against a company's list of sic codes for a match to occur in the results. The list of possible sic codes that may be used here (the taxonomy of sic codes) will be hand delivered via the support team as this is not public information. - String
naicsCodes
A list of naics codes to query against. Note that this is NOT a fuzzy match and naics codes here must be matched explicitly against a company's list of naics codes for a match to occur in the results. The list of possible naics codes that may be used here (the taxonomy of naics codes) will be hand delivered via the support team as this is not public information. - String
employeesRanges
A list of company sizes based on employee ranges to query against. Note that this is NOT a fuzzy match and values here must be matched explicitly against a company's employee range count for a match to occur in the results. The list of possible ranges that may be used here (the taxonomy of ranges) will be hand delivered via the support team as this is not public information. - String
pageNumber

minimum: 1

Page number to retrieve. Note that results will never exceed 10,000 and there are 20 results per page. This means that this number must never be less then 0 or greater then 500 as 500*20=10,000 - Integer

QUERY TEMPLATE

{

“regions”: [
“string”
],

“countries”: [
“string”
],

“states”: [ “string”
],

“cities”: [
“string”
],

“jobTitles”: [ “string”
],

“departments”: [
“string”
],

“managementLevels”: [
“string”
],

“sicCodes”: [
“string”
],

“naicsCodes”: [
“string”
],

“employeesRanges”: [
“string”
],

“annualRevenues”: [
“string”
],

“industries”: [
“string”
],

“pageNumber”: 0
}
{

“regions”: [
“string”
],

“countries”: [
“string”
],

“states”: [ “string”
],

“cities”: [
“string”
],

“jobTitles”: [ “string”
],

“departments”: [
“string”
],

“managementLevels”: [
“string”
],

“sicCodes”: [
“string”
],

“naicsCodes”: [
“string”
],

“employeesRanges”: [
“string”
],

“annualRevenues”: [
“string”
],

“industries”: [
“string”
],

“pageNumber”: 0
}

RESPONSE TEMPLATE

{

“results”:[
{
“contact_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“contact_company”:{
“acquisition_amount”:“string”,
“acquisition_company_name”:“string”,
“acquisition_date”:“string”,
“annual_revenue_amount”:“string”,
“buzz_words”:[
“string”
],
“company_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“company_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“company_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“company_name”:“string”,
“company_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“company_type”:“string”,
“company_type_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“description”:“string”,
“employee_size”:“string”,
“fax”:“string”,
“fiscal_year_end_month”:“string”,
“founded_year”:“string”,
“id”:“string”,
“industry_categories_list”:[
“string”
],
“investment_amount”:“string”,
“investment_company_name”:“string”,
“investment_description”:“string”,
“investment_end_date”:“string”,
“investment_round”:“string”,
“investment_started_date”:“string”,
“naics_code”:“string”,
“projected_revenue_amount”:“string”,
“projected_revenue_period_in_years”:“string”,
“public_status”:“string”,
“sic_code”:“string”,
“tech_keywords”:[
“string”
],
“updated_at”:“string”,
“updated_by”:“string”,
“website”:“string”
},
“contact_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:“string”,
“contact_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“end_date”:“string”,
“id”:“string”,
“job_dept”:“string”,
“job_function”:“string”,
“job_role”:“string”,
“job_title”:“string”,
“job_title_level”:“string”,
“reporting_authority”:“string”,
“start_date”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
},
“contact_name”:“string”,
“contact_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“contact_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“created_at”:“string”,
“created_by”:“string”,
“dob”:“string”,
“first_name”:“string”,
“gender”:“string”,
“last_name”:“string”,
“midddle_name”:“string”,
“middle_name”:“string”,
“reach_id”:0,
“suffix”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
}
],
“totalResultsCount”:0
}
{

“results”:[
{
“contact_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“contact_company”:{
“acquisition_amount”:“string”,
“acquisition_company_name”:“string”,
“acquisition_date”:“string”,
“annual_revenue_amount”:“string”,
“buzz_words”:[
“string”
],
“company_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“company_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“company_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“company_name”:“string”,
“company_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“company_type”:“string”,
“company_type_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“description”:“string”,
“employee_size”:“string”,
“fax”:“string”,
“fiscal_year_end_month”:“string”,
“founded_year”:“string”,
“id”:“string”,
“industry_categories_list”:[
“string”
],
“investment_amount”:“string”,
“investment_company_name”:“string”,
“investment_description”:“string”,
“investment_end_date”:“string”,
“investment_round”:“string”,
“investment_started_date”:“string”,
“naics_code”:“string”,
“projected_revenue_amount”:“string”,
“projected_revenue_period_in_years”:“string”,
“public_status”:“string”,
“sic_code”:“string”,
“tech_keywords”:[
“string”
],
“updated_at”:“string”,
“updated_by”:“string”,
“website”:“string”
},
“contact_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:“string”,
“contact_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“end_date”:“string”,
“id”:“string”,
“job_dept”:“string”,
“job_function”:“string”,
“job_role”:“string”,
“job_title”:“string”,
“job_title_level”:“string”,
“reporting_authority”:“string”,
“start_date”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
},
“contact_name”:“string”,
“contact_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“contact_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“created_at”:“string”,
“created_by”:“string”,
“dob”:“string”,
“first_name”:“string”,
“gender”:“string”,
“last_name”:“string”,
“midddle_name”:“string”,
“middle_name”:“string”,
“reach_id”:0,
“suffix”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
}
],
“totalResultsCount”:0
}

Segment API Data

Given a set of filter(s) that are targeted towards a segment, this API will perform a search and return matching contact. The data that is returned will be completely unmasked and ready for consumption.

QUERY TEMPLATE

{

“regions”: [
“string”
],

“countries”: [
“string”
],

“states”: [ “string”
],

“cities”: [
“string”
],

“jobTitles”: [ “string”
],

“departments”: [
“string”
],

“managementLevels”: [
“string”
],

“sicCodes”: [
“string”
],

“naicsCodes”: [
“string”
],

“employeesRanges”: [
“string”
],

“annualRevenues”: [
“string”
],

“industries”: [
“string”
],

“pageNumber”: 0
}
{

“regions”: [
“string”
],

“countries”: [
“string”
],

“states”: [ “string”
],

“cities”: [
“string”
],

“jobTitles”: [ “string”
],

“departments”: [
“string”
],

“managementLevels”: [
“string”
],

“sicCodes”: [
“string”
],

“naicsCodes”: [
“string”
],

“employeesRanges”: [
“string”
],

“annualRevenues”: [
“string”
],

“industries”: [
“string”
],

“pageNumber”: 0
}

RESPONSE TEMPLATE

{

“results”:[
{
“contact_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“contact_company”:{
“acquisition_amount”:“string”,
“acquisition_company_name”:“string”,
“acquisition_date”:“string”,
“annual_revenue_amount”:“string”,
“buzz_words”:[
“string”
],
“company_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“company_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“company_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“company_name”:“string”,
“company_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“company_type”:“string”,
“company_type_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“description”:“string”,
“employee_size”:“string”,
“fax”:“string”,
“fiscal_year_end_month”:“string”,
“founded_year”:“string”,
“id”:“string”,
“industry_categories_list”:[
“string”
],
“investment_amount”:“string”,
“investment_company_name”:“string”,
“investment_description”:“string”,
“investment_end_date”:“string”,
“investment_round”:“string”,
“investment_started_date”:“string”,
“naics_code”:“string”,
“projected_revenue_amount”:“string”,
“projected_revenue_period_in_years”:“string”,
“public_status”:“string”,
“sic_code”:“string”,
“tech_keywords”:[
“string”
],
“updated_at”:“string”,
“updated_by”:“string”,
“website”:“string”
},
“contact_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:“string”,
“contact_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“end_date”:“string”,
“id”:“string”,
“job_dept”:“string”,
“job_function”:“string”,
“job_role”:“string”,
“job_title”:“string”,
“job_title_level”:“string”,
“reporting_authority”:“string”,
“start_date”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
},
“contact_name”:“string”,
“contact_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“contact_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“created_at”:“string”,
“created_by”:“string”,
“dob”:“string”,
“first_name”:“string”,
“gender”:“string”,
“last_name”:“string”,
“midddle_name”:“string”,
“middle_name”:“string”,
“reach_id”:0,
“suffix”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
}
],
“totalResultsCount”:0
}
{

“results”:[
{
“contact_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“contact_company”:{
“acquisition_amount”:“string”,
“acquisition_company_name”:“string”,
“acquisition_date”:“string”,
“annual_revenue_amount”:“string”,
“buzz_words”:[
“string”
],
“company_addresses”:{
“address_type”:“string”,
“street_name”:“string”,
“city_name”:“string”,
“country_id”:0,
“country_name”:“string”,
“region”:“string”,
“state_name”:“string”,
“zip_code”:“string”
},
“company_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“company_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“company_name”:“string”,
“company_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“company_type”:“string”,
“company_type_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“description”:“string”,
“employee_size”:“string”,
“fax”:“string”,
“fiscal_year_end_month”:“string”,
“founded_year”:“string”,
“id”:“string”,
“industry_categories_list”:[
“string”
],
“investment_amount”:“string”,
“investment_company_name”:“string”,
“investment_description”:“string”,
“investment_end_date”:“string”,
“investment_round”:“string”,
“investment_started_date”:“string”,
“naics_code”:“string”,
“projected_revenue_amount”:“string”,
“projected_revenue_period_in_years”:“string”,
“public_status”:“string”,
“sic_code”:“string”,
“tech_keywords”:[
“string”
],
“updated_at”:“string”,
“updated_by”:“string”,
“website”:“string”
},
“contact_emails”:[
{
“email”:“string”,
“email_verified_status”:TRUE
}
],
“contact_job”:{
“company_id”:“string”,
“contact_id”:“string”,
“created_at”:“string”,
“created_by”:“string”,
“end_date”:“string”,
“id”:“string”,
“job_dept”:“string”,
“job_function”:“string”,
“job_role”:“string”,
“job_title”:“string”,
“job_title_level”:“string”,
“reporting_authority”:“string”,
“start_date”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
},
“contact_name”:“string”,
“contact_phones”:[
{
“is_active”:true,
“phone”:“string”,
“phone_ext”:“string”,
“phone_type”:“string”
}
],
“contact_social_media”:[
{
“is_active”:true,
“url”:“string”,
“social_media_type”:“string”
}
],
“created_at”:“string”,
“created_by”:“string”,
“dob”:“string”,
“first_name”:“string”,
“gender”:“string”,
“last_name”:“string”,
“midddle_name”:“string”,
“middle_name”:“string”,
“reach_id”:0,
“suffix”:“string”,
“updated_at”:“string”,
“updated_by”:“string”
}
],
“totalResultsCount”:0
}

Schema

The Reach API features well-formatted and strict schema for request and response payloads to provide a deterministic programming experience. In the developer portal, developers will be able to view the JSON Schema (https://json-schema.org/) for each API.

This ensures that there is no ambiguity in the programming experience. There is a strict contract in all traffic so that bugs or confusion are eliminated during the development experience.

Models are made available with the documentation for both request and response payloads. Developers are encouraged to take advantage of the various JSON schema utilities such as code generation to assist the development experience further:

https://json-schema.org/implementations.html

Contact Schema

As a reference, shown below is the JSON schema representing a contact. Note that you can see this inside the developer portal as well. It is shown here to provide insight into the type of data returned for a contact:

JSON Schema

“$schema”: “http://json-schema.org/draft-07/schema#”,

“definitions”:
{
“address”:
{
“title” : “Address”,
“type”: “object”,
“properties”:
{
“address_type”:
{“type”: “string” },

“street_name”:
{“type”: “string” },

“city_name”:
{“type”: “string” },

“country_id”:
{“type”: “integer” },

“country_name”:
{“type”: “string” },

“region”:
{“type”: “string” },

“state_name”:
{“type”: “string” },

“zip_code”:
{“type”: “string” }
}

},
“email”:
{
“title” : “Email”,
“type”: “object”,
“properties”:
{
“email”:
{“type”: “string” },

“email_verified_status”:
{“type”: “boolean” }
}

},
“phone”:
{
“title” : “Phone”,
“type”: “object”,
“properties”:
{
“is_active”:
{“type”: “boolean” },

“phone”:
{“type”: “string” },

“phone_ext”:
{“type”: “string” },

“phone_type”:
{“type”: “string” }
}

},
“social_media”:
{
“title” : “Social Media”,
“type”: “object”,
“properties”:
{
“is_active”:
{“type”: “boolean” },

“url”:
{“type”: “string” },

“social_media_type”:
{“type”: “string” }
}

},
“contact_company”:
{
“title” : “Company”,
“type”: “object”,
“properties”:
{
“acquisition_amount”:
{
“type”: “string”
},
“acquisition_company_name”:
{
“type”: “string”
},
“acquisition_date”:
{
“type”: “string”
},
“annual_revenue_amount”:
{
“type”: “string”
},
“buzz_words”:
{
“type”: “array”,
“items”:
{
“type”: “string”
}

},
“company_addresses”:
{
“$ref”: “#/definitions/address”
},
“company_emails”:
{
“type”: “array”,
“items”:
{
“$ref”: “#/definitions/email”
}

},
“company_phones”:
{
“type”: “array”,
“items”:
{
“$ref”: “#/definitions/phone”
}

},
“company_name”:
{
“type”: “string”
},
“company_social_media”:
{
“type”: “array”,
“items”:
{
“$ref”: “#/definitions/social_media”
}

},
“company_type”:
{
“type”: “string”
},
“company_type_id”:
{
“type”: “string”
},
“created_at”:
{
“type”: “string”
},
“created_by”:
{
“type”: “string”
},
“description”:
{
“type”: “string”
},
“employee_size”:
{
“type”: “string”
},
“fax”:
{
“type”: “string”
},
“fiscal_year_end_month”:
{
“type”: “string”
},
“founded_year”:
{
“type”: “string”
},
“id”:
{
“type”: “string”
},
“industry_categories_list”:
{
“type”: “array”,
“items”:
{
“type”: “string”
}

},
“investment_amount”:
{
“type”: “string”
},
“investment_company_name”:
{
“type”: “string”
},
“investment_description”:
{
“type”: “string”
},
“investment_end_date”:
{
“type”: “string”
},
“investment_round”:
{
“type”: “string”
},
“investment_started_date”:
{
“type”: “string”
},
“naics_code”:
{
“type”: “string”
},
“projected_revenue_amount”:
{
“type”: “string”
},
“projected_revenue_period_in_years”:
{
“type”: “string”
},
“public_status”:
{
“type”: “string”
},
“sic_code”:
{
“type”: “string”
},
“tech_keywords”:
{
“type”: “array”,
“items”:
{
“type”: “string”
}

},
“updated_at”:
{
“type”: “string”
},
“updated_by”:
{
“type”: “string”
},
“website”:
{
“type”: “string”
}

}

},
“contact_job”:
{
“title” : “Job”,
“type”: “object”,
“properties”:
{
“company_id”:
{
“type”: “string”
},
“contact_id”:
{
“type”: “string”
},
“created_at”:
{
“type”: “string”
},
“created_by”:
{
“type”: “string”
},
“end_date”:
{
“type”: “string”
},
“id”:
{
“type”: “string”
},
“job_dept”:
{
“type”: “string”
},
“job_function”:
{
“type”: “string”
},
“job_role”:
{
“type”: “string”
},
“job_title”:
{
“type”: “string”
},
“job_title_level”:
{
“type”: “string”
},
“reporting_authority”:
{
“type”: “string”
},
“start_date”:
{
“type”: “string”
},
“updated_at”:
{
“type”: “string”
},
“updated_by”:
{
“type”: “string”
}

}

}

},
“type”: “object”,
“title” : “Contact”,
“properties”:
{
“contact_addresses”:
{“$ref”: “#/definitions/address” },

“contact_company”:
{“$ref”: “#/definitions/contact_company” },

“contact_emails”: {“type”: “array”,
“items”:
{
“$ref”: “#/definitions/email”
}

},
“contact_job”:
{
“$ref”: “#/definitions/contact_job”
},
“contact_name”:
{“type”: “string” },

“contact_phones”: {“type”: “array”,
“items”:
{
“$ref”: “#/definitions/phone”
}

},
“contact_social_media”: {“type”: “array”,
“items”:
{
“$ref”: “#/definitions/social_media”
}

},
“created_at”:
{“type”: “string” },

“created_by”:
{“type”: “string” },

“dob”:
{“type”: “string” },

“first_name”:
{“type”: “string” },

“gender”:
{“type”: “string” },

“last_name”:
{“type”: “string” },

“midddle_name”:
{“type”: “string” },

“middle_name”:
{“type”: “string” },

“reach_id”:
{“type”: “integer” },

“suffix”:
{“type”: “string” },

“updated_at”:
{“type”: “string” },

“updated_by”:
{“type”: “string” }
}

“$schema”: “http://json-schema.org/draft-07/schema#”,

“definitions”:
{
“address”:
{
“title” : “Address”,
“type”: “object”,
“properties”:
{
“address_type”:
{“type”: “string” },

“street_name”:
{“type”: “string” },

“city_name”:
{“type”: “string” },

“country_id”:
{“type”: “integer” },

“country_name”:
{“type”: “string” },

“region”:
{“type”: “string” },

“state_name”:
{“type”: “string” },

“zip_code”:
{“type”: “string” }
}

},
“email”:
{
“title” : “Email”,
“type”: “object”,
“properties”:
{
“email”:
{“type”: “string” },

“email_verified_status”:
{“type”: “boolean” }
}

},
“phone”:
{
“title” : “Phone”,
“type”: “object”,
“properties”:
{
“is_active”:
{“type”: “boolean” },

“phone”:
{“type”: “string” },

“phone_ext”:
{“type”: “string” },

“phone_type”:
{“type”: “string” }
}

},
“social_media”:
{
“title” : “Social Media”,
“type”: “object”,
“properties”:
{
“is_active”:
{“type”: “boolean” },

“url”:
{“type”: “string” },

“social_media_type”:
{“type”: “string” }
}

},
“contact_company”:
{
“title” : “Company”,
“type”: “object”,
“properties”:
{
“acquisition_amount”:
{
“type”: “string”
},
“acquisition_company_name”:
{
“type”: “string”
},
“acquisition_date”:
{
“type”: “string”
},
“annual_revenue_amount”:
{
“type”: “string”
},
“buzz_words”:
{
“type”: “array”,
“items”:
{
“type”: “string”
}

},
“company_addresses”:
{
“$ref”: “#/definitions/address”
},
“company_emails”:
{
“type”: “array”,
“items”:
{
“$ref”: “#/definitions/email”
}

},
“company_phones”:
{
“type”: “array”,
“items”:
{
“$ref”: “#/definitions/phone”
}

},
“company_name”:
{
“type”: “string”
},
“company_social_media”:
{
“type”: “array”,
“items”:
{
“$ref”: “#/definitions/social_media”
}

},
“company_type”:
{
“type”: “string”
},
“company_type_id”:
{
“type”: “string”
},
“created_at”:
{
“type”: “string”
},
“created_by”:
{
“type”: “string”
},
“description”:
{
“type”: “string”
},
“employee_size”:
{
“type”: “string”
},
“fax”:
{
“type”: “string”
},
“fiscal_year_end_month”:
{
“type”: “string”
},
“founded_year”:
{
“type”: “string”
},
“id”:
{
“type”: “string”
},
“industry_categories_list”:
{
“type”: “array”,
“items”:
{
“type”: “string”
}

},
“investment_amount”:
{
“type”: “string”
},
“investment_company_name”:
{
“type”: “string”
},
“investment_description”:
{
“type”: “string”
},
“investment_end_date”:
{
“type”: “string”
},
“investment_round”:
{
“type”: “string”
},
“investment_started_date”:
{
“type”: “string”
},
“naics_code”:
{
“type”: “string”
},
“projected_revenue_amount”:
{
“type”: “string”
},
“projected_revenue_period_in_years”:
{
“type”: “string”
},
“public_status”:
{
“type”: “string”
},
“sic_code”:
{
“type”: “string”
},
“tech_keywords”:
{
“type”: “array”,
“items”:
{
“type”: “string”
}

},
“updated_at”:
{
“type”: “string”
},
“updated_by”:
{
“type”: “string”
},
“website”:
{
“type”: “string”
}

}

},
“contact_job”:
{
“title” : “Job”,
“type”: “object”,
“properties”:
{
“company_id”:
{
“type”: “string”
},
“contact_id”:
{
“type”: “string”
},
“created_at”:
{
“type”: “string”
},
“created_by”:
{
“type”: “string”
},
“end_date”:
{
“type”: “string”
},
“id”:
{
“type”: “string”
},
“job_dept”:
{
“type”: “string”
},
“job_function”:
{
“type”: “string”
},
“job_role”:
{
“type”: “string”
},
“job_title”:
{
“type”: “string”
},
“job_title_level”:
{
“type”: “string”
},
“reporting_authority”:
{
“type”: “string”
},
“start_date”:
{
“type”: “string”
},
“updated_at”:
{
“type”: “string”
},
“updated_by”:
{
“type”: “string”
}

}

}

},
“type”: “object”,
“title” : “Contact”,
“properties”:
{
“contact_addresses”:
{“$ref”: “#/definitions/address” },

“contact_company”:
{“$ref”: “#/definitions/contact_company” },

“contact_emails”: {“type”: “array”,
“items”:
{
“$ref”: “#/definitions/email”
}

},
“contact_job”:
{
“$ref”: “#/definitions/contact_job”
},
“contact_name”:
{“type”: “string” },

“contact_phones”: {“type”: “array”,
“items”:
{
“$ref”: “#/definitions/phone”
}

},
“contact_social_media”: {“type”: “array”,
“items”:
{
“$ref”: “#/definitions/social_media”
}

},
“created_at”:
{“type”: “string” },

“created_by”:
{“type”: “string” },

“dob”:
{“type”: “string” },

“first_name”:
{“type”: “string” },

“gender”:
{“type”: “string” },

“last_name”:
{“type”: “string” },

“midddle_name”:
{“type”: “string” },

“middle_name”:
{“type”: “string” },

“reach_id”:
{“type”: “integer” },

“suffix”:
{“type”: “string” },

“updated_at”:
{“type”: “string” },

“updated_by”:
{“type”: “string” }
}

Request Validation

As mentioned earlier, each API with a POST body will have a list of filters to query for. These filters’ schema will be available as a JSON schema available to see in the developer portal. 

This error indicates that the user’s request contains incorrect syntax. This could be due to the request URL or it’s payload (if applicable).

400 Bad Request

This error indicates that the user’s request contains incorrect syntax. This could be due to the request URL or it’s payload (if applicable).

403 Forbidden

This error indicates that the server will not allow the caller to access the requested API – likely due to an invalid API key. Remember that all API calls must have “x-api-key” as a header for all requests.

404 Not Found

This error indicates that the server could not find the API endpoint that the caller requested. This commonly occurs when a URL is mistyped.

404 Not Found

This error indicates that the server could not find the API endpoint that the caller requested. This commonly occurs when a URL is mistyped.

429 Too many requests

This error indicates that the client has exceeded quota. This could be due to too many requests within the last second (concurrency) or due to the monthly quota expiring.

500 Internal Server Error

This error indicates that the server has faced a critical internal error. if this happens please reach out to us at support@reachstream.com

Custom Taxonomy

As mentioned earlier, many of the APIs operate on certain filters as part of the request payload. These filters offer the ability to query based on filters such as country, job title, industry, SIC code, and much more. It becomes clear that the ease of use of these filters and their possible values are paramount to developer happiness. To further ensure an accurate experience for the developer and applications built on the API, the Reach API is proud to offer a rich taxonomy or classification system for certain API fields. This means we have enumerated values possible for many of the filters within the APIs. This means, for example, there exists a finite set of possible values for filters such as industries, job titles, SIC codes, etc… No guesswork is needed when using our APIs.

Benefits of this include:

  • A tightly coupled programming experience
  • Results are returned match exactly what is intended by the query
  • The contract on the data showcases exactly what possible values we support
  • Overall there is no ambiguity and explicit clarity on what we support
  • The software that uses these APIs can allow a human user to choose from these enumeration values (similar to dropdowns in a web form) to ensure they get exactly what they desire.

Note that the enumerated taxonomy (possible values for each filter) are NOT public information. They are given to our customers privately as CSV files, which can then be used when the API is accessed. As we refine our classification system, this taxonomy may modify (slightly) a few times a year. When this happens, we proactively reach out to our customers to notify them of the changes.

Authentication

The Reach API uses an API key to authenticate requests. You can view and manage your API key in your own developer portal. Note that one API key is used for all APIs. Your API keys carry many privileges, so be sure to keep them secure! Do not share your private API keys in publicly accessible areas such as GitHub, client-side code, and so forth. Authentication to the API is performed by placing this API key as a header in the request. Details on the header name are available inside the developer portal. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Quota

Each of the APIs offered within the Reach API platform has a built-in quota per month. Your quota will be determined during the onboarding process with one of our sales representatives.

Subsequently, developers can see how much quota has been used in the current month and how much quota is remaining in the developer portal.

Further quota may be added either permanently or within the current month by reaching out to our support team. When the quota is exceeded, an HTTP 429 is returned to the client.

Rate Limits

The Reach API employs safeguards against bursts of incoming traffic to help maximize its stability. We have two limiters in the API, including:

Rate limits

A rate limiter that limits the number of requests received by the API within any given second.

Burst limits

A concurrency limiter that limits the number of active requests at any given moment in time.

Both of these will be set up during your onboarding process. Violations of either of these will result in HTTP 429 being returned.

Our APIs are built on top of the Amazon AWS API Gateway platform. More details on rate limits and burst limits can be found at:

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-request-throttling.html

If higher queries per second or higher concurrency is needed, please reach out to your support staff so we can assist you in increasing these.

Request a demo

First name *
Last name *
Job title *
Company *
Phone number *
Work email *
Select ReachAPI *
Request a Contact ReachID APIRequest a Contact APIRequest a Segment API
How can we help?


Service Level Agreement

The type of Reach API queries, the frequency with which you can issue them, the data elements returned, and the volume of data returned depend on the scope of features defined in your License Agreement.

REACHSTREAM DIRECTORIES

  • Browse People Directory
  • Browse Business Directory

Search by last name- A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Search by city – Boston | New York City | Houston | Chicago | Los Angeles | Atlanta

Search by states-      AK AZ AL AR CA CO CT DE FL GA HI ID IL IN IA KS KY LA ME MA MI MN MS MO MT NE NV NH NJ NM NY NC ND OH OK OR PA RI SC SD TN TX UT VT VA WA WV WI WY

Copyright © 2020 ReachStream, Inc.    Privacy    Terms & Conditions     Cookies Policy

Sign up for a free trial, Register Now

Bitnami