Lead insights

Companies

Endpoints

`/v3/companies/v1.0/company/match`

The company/match endpoint allows you to retrieve high-level firmographic data for a matched company by providing one of the following combinations in your request:

Employee Identification Number (EIN) and one of the following (Name, Address, or Phone)
Name and Address

This endpoint is crucial to using the other methods in this API, as it returns a crucial id required for all other endpoints.

Example

The following example demonstrates how to successfully use the Company Match endpoint to retrieve information about a company. In the example, we'll use the following information to make the request:

Company Name: Zywave
Address: 10100 W. Innovation Drive, Milwaukee, Wisconsin

curl -G --location 'https://api.zywave.com/v3/companies/v1.0/company/match' --data-urlencode 'name=Zywave' --data-urlencode 'addressLine1=10100 W. Innovation Drive' --data-urlencode 'city=Milwaukee' --data-urlencode 'state=Wisconsin' --header 'Authorization: Bearer ${ACCESS_TOKEN}'

[
  {
    "description": "Zywave's insurance agency software is used by more than 5,000 insurance agencies, including 95 of the Top 100 U.S. insurance firms. Schedule a demo today.",
    "ein": "391810743",
    "employeeCount": 890,
    "employeeRange": "500 - 999",
    "facebookUrl": "http://www.facebook.com/zywave/",
    "id": "M84000000000011",
    "linkedinUrl": "http://www.linkedin.com/company/zywave",
    "naicsCode": "541990",
    "name": "ZYWAVE",
    "phoneNumber": "14144546100",
    "primaryAddress": {
      "addressLine1": "10100 W INNOVATION DR STE 300",
      "addressLine2": "",
      "city": "MILWAUKEE",
      "country": "UNITED STATES",
      "county": "MILWAUKEE",
      "postalCode": "53226",
      "state": "WI"
    },
    "revenueRange": "50M - 100M",
    "twitterUrl": "https://twitter.com/zywave",
    "websiteUrl": "http://zywave.com",
    "score": 22
  }
]

using System.Net.Http;

HttpClient client = new HttpClient();

HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, "https://api.zywave.com/v3/companies/v1.0/company/match?name=Zywave&addressLine1=10100+W.+Innovation+Drive&city=Milwaukee&state=Wisconsin");

request.Headers.Add("Authorization", "Bearer ${ACCESS_TOKEN}");

HttpResponseMessage response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newBuilder()
    .followRedirects(HttpClient.Redirect.NORMAL)
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zywave.com/v3/companies/v1.0/company/match?name=Zywave&addressLine1=10100+W.+Innovation+Drive&city=Milwaukee&state=Wisconsin"))
    .GET()
    .setHeader("Authorization", "Bearer ${ACCESS_TOKEN}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

fetch('https://api.zywave.com/v3/companies/v1.0/company/match?name=Zywave&addressLine1=10100+W.+Innovation+Drive&city=Milwaukee&state=Wisconsin', {
  headers: {
    'Authorization': 'Bearer ${ACCESS_TOKEN}'
  }
});

import requests

headers = {
    'Authorization': 'Bearer ${ACCESS_TOKEN}',
}

params = {
    'name': 'Zywave',
    'addressLine1': '10100 W. Innovation Drive',
    'city': 'Milwaukee',
    'state': 'Wisconsin',
}

response = requests.get('https://api.zywave.com/v3/companies/v1.0/company/match', params=params, headers=headers)

`/v3/companies/v1.0/company/{id}`

The company/{id} endpoint retrieves high-level firmographic data for the given company id.

Here are examples of when you might use this endpoint:

Data comparison: If you are looking to compare your data to our data.
Data discovery: You can enhance your data by requesting this endpoint with a valid id.

`/v3/companies/v1.0/company/{id}/contacts`

The company/{id}/contacts endpoint retrieves contacts associated with the given company id.

Here are examples of when you might use this endpoint:

Data discovery: You can enhance your data and generate potential leads.

`/v3/companies/v1.0/company/{id}/details`

This endpoint provides comprehensive information for a company including alternate names, addresses, phone numbers, NAICS codes, and EINs that are known.

Here are examples of when you might use this endpoint:

Data discovery: If you are looking to retrieve comprehensive information about a company.
You can utilize this endpoint by providing the company id.

Health & Welfare

Endpoints

`/v3/companies/v1.0/company/{id}/welfare/details`

The welfare/details endpoint provides comprehensive welfare data corresponding to the provided company id.

Here are examples of when you might use this endpoint:

Data discovery: If you are looking to retrieve comprehensive welfare information about a company.
You can utilize this endpoint by providing the company id.

`/v3/companies/v1.0/company/{id}/welfare/summary`

The welfare/summary endpoint provides a high-level overview of welfare data for a corresponding company.

Here are examples of when you might use this endpoint:

Data discovery: If you are looking to retrieve a high-level overview of welfare information about a company. You can utilize this endpoint by providing the company id.

Commercial

Note: The California Exmod data is currently unavailable through our API due to certain criteria specific to California that cannot be confirmed via the API.

The criteria are as follows:

You possess the rightful entitlement to access the coverage information.
The provided information will be strictly utilized in conjunction with an ongoing workers’ compensation claim.
You commit that the information shall not be disclosed, distributed, or made available to any third parties through publication or otherwise.

If you require California Exmod data, please contact Zywave.

Endpoints

`/v3/companies/v1.0/company/{id}/commercial/details`

The commercial/details endpoint provides comprehensive commercial data corresponding to the provided company 'id'.

Here are examples of when you might use this endpoint:

Data discovery: If you are looking to retrieve comprehensive commercial information about a company.
You can utilize this endpoint by providing the company id.

`/v3/companies/v1.0/company/{id}/commercial/summary`

The commercial/summary endpoint provides a high-level overview of commercial data for a corresponding company.

Here are examples of when you might use this endpoint:

Data discovery: If you are looking to retrieve a high-level overview of commercial information about a company. You can utilize this endpoint by providing the company id.

Specification

Base URL: https://api.zywave.com OpenAPI spec