/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:
This endpoint is crucial to using the other methods in this API, as it returns a crucial id
required for all other endpoints.
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:
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:
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:
/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:
id
./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:
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:
id
.The criteria are as follows:
If you require California Exmod data, please contact Zywave.
/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:
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:
id
.