Introduction
Welcome to supplier.io APIs! Here you’ll find comprehensive information for integrating with our API endpoints. We’ve tried to make this documentation user-friendly and example-filled, but if you have any questions, please contact your account representative. The fastest way to get your integration up and running is to use our quickstart guide, which walks through your entire integration step-by-step. You’ll integrate API into your site or app and use it to retrieve the data you need from our database.
Overview
API keys and access
To gain access to the supplier.io API, please request an account key from your account representative. Once you’ve received the signup process and acknowledged our terms, we’ll provide a live API Key and CustomerID.
API protocols
The API uses GET and POST requests to communicate and HTTP response codes to indicate status and errors. All responses come in standard JSON. The API is served over HTTPS TLS v1.2+ to ensure data privacy; HTTP and HTTPS with TLS versions below 1.2 are not supported. All requests must include a Content-Type of application/json and the body must be valid JSON.
API host
https://api.supplierio.com/supplier (Development)
https://api.supplier.io/supplier (Production)
The Sandbox and Development environments are unrestricted and support only test Items. All testing should be done in our Sandbox and Development environments. All activities in the Production environment will be billed. When you’re getting ready to launch into Production, please request Production API access.
Endpoints
Project/CreateProject
/GetProjects
Search
/GetSearchDetail
/GetMatch
/GetMatchWithQuality
/GetBestMatch
/GetBestMatchV2
/SubmitMatch
/SubmitMatchV2
/GetMatchResults
Suppliers
/GetSupplierDetail
/GetSuppliers
Grace Period
For the endpoints mentioned above, there is an 18-month grace period for the expiration dates on supplier records' certifications. This 18-month duration is fixed and cannot be altered; any suppliers whose certifications expired within the last 18 months will be considered a match.
Storing supplier.io API identifiers
It’s important to properly handle supplier.io identifiers returned by the API endpoints. supplier.io identifiers let you associate API and supplier details with your requests, and will help our Support team resolve your issues faster and more accurately. Here are some best practices for handling our API identifiers.
supplier_id
supplier_ids are the core identifiers that map to records in the supplier.io database. You should persist them in your application storage. Note, however, that supplier_ids are frequently retired and replaced with new supplier_ids. The response always returns the latest supplier_id. If it has changed from your original request, you should update it in your application storage.
If you are using the API across multiple clients, the customerID identifies the client for each request.
Breaking changes
We strive to avoid making any breaking changes to our API, but we do make changes over time that may result in changes to the data that you pull from supplier.io.
We consider the following changes to be backward compatible:
- Adding new API endpoints
- Adding new options parameters to existing endpoints
- Adding new data elements to existing response schemas
- Adding new error_types and error_codes
- Adding new webhook_types and webhook_codes
- Changing the length or content of any API identifier
What’s New in V2
API V2 introduces a new and significantly improved matching engine compared to V1. This new engine is designed to deliver more accurate and efficient results, aligning with our long-term goal of fully replacing the current V1 engine. One of the key enhancements in V2 is that it returns only High-quality matches.
Please also note that the GetMatchWithQuality endpoint will not be promoted to V2, as the new matching engine inherently focuses on delivering high-quality matches only.
Category Definitions
| Category Type | Category Name | Acronym | Definition |
|---|
API Project
The API offers endpoints for creating projects, retrieving project IDs, and marking projects as complete. The project ID is subsequently used in matching-related endpoints—such as GetBestMatch, SubmitMatch, GetBestMatchV2, and SubmitMatchV2—to associate and display results on the DE dashboard.
CreateProject
Creates a new project for the authenticated customer.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| ProjectName | Yes | The name of the project. Must be unique across all existing projects. |
Request Example
In Params
KEY : VALUE
------------------------------------------------------------
APIKey : b18f18f036104787af0142f7c0fc4e39
customerId : 98375
In Body Row JSON
{
"ProjectName": "TestProject"
}
Results Example
{
"StatusCode": 200,
"Message": "Project created successfully.",
"Data": {
"ProjectId": "76bc1aa1-6342-4559-9aa2-2811c682b225",
"ProjectName": "TestProject",
"Status": "Open"
},
"Errors": null
}
GetProjects
Retrieves a list of all projects associated with the authenticated customer.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name |
Results Example
{
"StatusCode": 200,
"Message": null,
"Data": [
{
"ProjectId": "85f6673d-7833-4bea-87b2-2fb6b9382a2d",
"ProjectName": "Test-9512_1",
"Status": "Open"
},
{
"ProjectId": "dfdd85d3-626a-46c1-b6b8-d6bef2cbec95",
"ProjectName": "Test-9512_2",
"Status": "Completed"
}
],
"Errors": null
}
Try it
Query
API result
Search
The API supports two types of searches:
- Database Search: Search requests run a query against the database based on the provided search parameters and filters.
- Matches: Match requests attempt to identify a specific supplier based on the provided criteria.
GetSearchDetail
This method returns the result of search against supplier.io database.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| searchQuery | No | Accepts string as a keyword search. | * |
| startRecord | No | The start record number for search results. | 0 |
| rowCount | No | The maximum value for the rowCount parameter is 500. If more records are needed beyond the initial 500 resulting suppliers, consider using the startRecord parameter in conjunction with rowCount to paginate through additional results. | 10 |
| organizationName | No | Filter Results by Supplier Name. | |
| location | No | Geocodes to limits search by location. Format: longitude, latitude | |
| locationDistance | No | Distance from entered location to limit search results. Used with location. Field is ignored if location parameter is blank. |
25 |
| locationUnit | No | Distance Unit(in miles or kilometer). Used with location. Field is ignored if location parameter is blank. |
miles |
| state | No |
State associated with the address. Provide the two letter State code if country is USA/CAN. Examples:
|
|
| country | No | Filter Results by Country(ISO 3166-1 alpha-3 country code) | USA/CAN |
| naicsCode | No | Filter Results by 6-digit NAICS Code(s) | |
| sicCode | No | Filter Results by 4-digit SIC Code(s) | |
| diversityClassification | No |
Filter Results by Diversity Classification. Values:
|
|
| sustainabilityClassification | No |
Filter Results by Sustainability Classification. Values:
|
|
| ethnicity | No |
Filter Results by Ethnicity. Values (format may change):
|
|
| employee | No |
Filter Results by Number of Employees. Values (format may change):
|
|
| revenue | No |
Filter Results by Company Revenues. Values (format may change):
|
|
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
- Multiple filters may be used simultaneously and each filter can accept multiple values.
- If multiple filter fields are used, an AND operator is applied across all the filters.
- If multiple values are used for a filter, an OR operator is applied across all the values.
- Multiple values for a filter must be separated using a vertical bar (|).
Examples:
- Multiple Filters with single values:
State=IL&Employee=1-10 -
Multiple Filters with multiple values:
State=IL|NJ&Employee=1-10
Results Example
{
"results": {
"Error": null,
"SearchQuery": "*",
"startRecord": "0",
"rowCount": "10",
"TotalRecords": "5000+",
"Results": [
{
"SupplierID": "100799337",
"SupplierName": "EMPLOYMENT SOLUTIONS, INC",
"Description": "",
"Address": "2900 HORIZON",
"City": "BRYANT",
"State": "AR",
"Zip": "72022",
"Country": "USA",
"TrustIQ": null
},
{
"SupplierID": "100799354",
"SupplierName": "GIBRALTER ROCK INC",
"Description": "",
"Address": "484 COUNTY RTE 601",
"City": "BELLE MEAD",
"State": "NJ",
"Zip": "08502",
"Country": "USA",
"TrustIQ": 4
},
{
"SupplierID": "100799356",
"SupplierName": "RADFORD AUTO AUCTION INC",
"Description": "",
"Address": "2500 TYLER RD",
"City": "CHRISTIANSBURG",
"State": "VA",
"Zip": "24073",
"Country": "USA",
"TrustIQ": 3
},
{
"SupplierID": "100799378",
"SupplierName": "FILLY FREIGHT & TRADE LLC",
"Description": "",
"Address": "17823 REFUGE LAKE",
"City": "CYPRESS",
"State": "TX",
"Zip": "77433",
"Country": "USA",
"TrustIQ": 3
},
{
"SupplierID": "100799383",
"SupplierName": "PEST SERVICES UNLIMITED INC",
"Description": "",
"Address": "55 CRYSTAL CREEK",
"City": "HATTIESBURG",
"State": "MS",
"Zip": "39402",
"Country": "USA",
"TrustIQ": null
},
{
"SupplierID": "100799392",
"SupplierName": "VARTEST LABORATORIES INC",
"Description": "",
"Address": "19 W 10",
"City": "NEW YORK",
"State": "NY",
"Zip": "10018",
"Country": "USA",
"TrustIQ": 5
},
{
"SupplierID": "100799393",
"SupplierName": "CKR",
"Description": "",
"Address": "5020 NICHOLSON CT",
"City": "KENSINGTON",
"State": "MD",
"Zip": "20895",
"Country": "USA",
"TrustIQ": null
},
{
"SupplierID": "100799411",
"SupplierName": "NETWORK INFRASTRUCTURE CABLING DESIGN LLC",
"Description": "ELECTRICAL CONTRACTORS AND OTHER WIRING INSTALLATION CONTRACTORS TELECOMMUNICATIONS EQUIPMENT AND WIRING EXCEPT TRANSMISSION LINE INSTALLATION CONTRACTORS",
"Address": "938 E SWAN CREEK RD",
"City": "FORT WASHINGTON",
"State": "MD",
"Zip": "20744",
"Country": "USA",
"TrustIQ": null
},
{
"SupplierID": "100799417",
"SupplierName": "SATO INGENIUM, INC.",
"Description": "",
"Address": "23818 BENNETT CHASE DR",
"City": "CLARKSBURG",
"State": "MD",
"Zip": "20871",
"Country": "USA",
"TrustIQ": null
},
{
"SupplierID": "100799418",
"SupplierName": "CHARLESTON LOGISTICS LLC",
"Description": "",
"Address": "78 ALEXANDER ST",
"City": "CHARLESTON",
"State": "SC",
"Zip": "29403",
"Country": "USA",
"TrustIQ": null
}
],
"Facets": {
"State": [
{
"Value": "CA",
"Count": "5000+",
"ActualCount": "75,726",
"ActualValue": "75726"
},
{
"Value": "TX",
"Count": "5000+",
"ActualCount": "52,337",
"ActualValue": "52337"
},
{
"Value": "FL",
"Count": "5000+",
"ActualCount": "43,030",
"ActualValue": "43030"
},
{
"Value": "VA",
"Count": "5000+",
"ActualCount": "39,500",
"ActualValue": "39500"
},
{
"Value": "NY",
"Count": "5000+",
"ActualCount": "32,755",
"ActualValue": "32755"
},
{
"Value": "MD",
"Count": "5000+",
"ActualCount": "28,687",
"ActualValue": "28687"
},
{
"Value": "GA",
"Count": "5000+",
"ActualCount": "21,941",
"ActualValue": "21941"
},
{
"Value": "IL",
"Count": "5000+",
"ActualCount": "20,824",
"ActualValue": "20824"
},
{
"Value": "PA",
"Count": "5000+",
"ActualCount": "20,227",
"ActualValue": "20227"
},
{
"Value": "NJ",
"Count": "5000+",
"ActualCount": "17,946",
"ActualValue": "17946"
},
{
"Value": "NC",
"Count": "5000+",
"ActualCount": "17,671",
"ActualValue": "17671"
},
{
"Value": "OH",
"Count": "5000+",
"ActualCount": "14,962",
"ActualValue": "14962"
},
{
"Value": "CO",
"Count": "5000+",
"ActualCount": "13,791",
"ActualValue": "13791"
},
{
"Value": "WA",
"Count": "5000+",
"ActualCount": "13,465",
"ActualValue": "13465"
},
{
"Value": "MI",
"Count": "5000+",
"ActualCount": "13,250",
"ActualValue": "13250"
},
{
"Value": "MA",
"Count": "5000+",
"ActualCount": "11,979",
"ActualValue": "11979"
},
{
"Value": "AZ",
"Count": "5000+",
"ActualCount": "11,067",
"ActualValue": "11067"
},
{
"Value": "MO",
"Count": "5000+",
"ActualCount": "9,778",
"ActualValue": "9778"
},
{
"Value": "LA",
"Count": "5000+",
"ActualCount": "9,414",
"ActualValue": "9414"
},
{
"Value": "Tn",
"Count": "5000+",
"ActualCount": "9,418",
"ActualValue": "9418"
},
{
"Value": "MN",
"Count": "5000+",
"ActualCount": "8,082",
"ActualValue": "8082"
},
{
"Value": "IN",
"Count": "5000+",
"ActualCount": "7,967",
"ActualValue": "7967"
},
{
"Value": "SC",
"Count": "5000+",
"ActualCount": "7,793",
"ActualValue": "7793"
},
{
"Value": "AL",
"Count": "5000+",
"ActualCount": "7,606",
"ActualValue": "7606"
},
{
"Value": "OR",
"Count": "5000+",
"ActualCount": "7,185",
"ActualValue": "7185"
},
{
"Value": "WI",
"Count": "5000+",
"ActualCount": "7,105",
"ActualValue": "7105"
},
{
"Value": "CT",
"Count": "5000+",
"ActualCount": "6,673",
"ActualValue": "6673"
},
{
"Value": "OK",
"Count": "5000+",
"ActualCount": "6,339",
"ActualValue": "6339"
},
{
"Value": "DC",
"Count": "5000+",
"ActualCount": "6,235",
"ActualValue": "6235"
},
{
"Value": "PR",
"Count": "5000+",
"ActualCount": "5,154",
"ActualValue": "5154"
},
{
"Value": "NV",
"Count": "4,996",
"ActualCount": "4,996",
"ActualValue": "4996"
},
{
"Value": "NM",
"Count": "4,963",
"ActualCount": "4,963",
"ActualValue": "4963"
},
{
"Value": "KY",
"Count": "4,829",
"ActualCount": "4,829",
"ActualValue": "4829"
},
{
"Value": "UT",
"Count": "4,651",
"ActualCount": "4,651",
"ActualValue": "4651"
},
{
"Value": "MS",
"Count": "4,604",
"ActualCount": "4,604",
"ActualValue": "4604"
},
{
"Value": "AR",
"Count": "4,199",
"ActualCount": "4,199",
"ActualValue": "4199"
},
{
"Value": "MT",
"Count": "4,152",
"ActualCount": "4,152",
"ActualValue": "4152"
},
{
"Value": "KS",
"Count": "4,029",
"ActualCount": "4,029",
"ActualValue": "4029"
},
{
"Value": "AK",
"Count": "3,808",
"ActualCount": "3,808",
"ActualValue": "3808"
},
{
"Value": "IA",
"Count": "3,746",
"ActualCount": "3,746",
"ActualValue": "3746"
},
{
"Value": "ID",
"Count": "3,672",
"ActualCount": "3,672",
"ActualValue": "3672"
},
{
"Value": "HI",
"Count": "3,176",
"ActualCount": "3,176",
"ActualValue": "3176"
},
{
"Value": "NE",
"Count": "3,142",
"ActualCount": "3,142",
"ActualValue": "3142"
},
{
"Value": "DE",
"Count": "2,605",
"ActualCount": "2,605",
"ActualValue": "2605"
},
{
"Value": "WV",
"Count": "2,355",
"ActualCount": "2,355",
"ActualValue": "2355"
},
{
"Value": "SD",
"Count": "2,236",
"ActualCount": "2,236",
"ActualValue": "2236"
},
{
"Value": "NH",
"Count": "2,199",
"ActualCount": "2,199",
"ActualValue": "2199"
},
{
"Value": "WY",
"Count": "1,791",
"ActualCount": "1,791",
"ActualValue": "1791"
},
{
"Value": "RI",
"Count": "1,767",
"ActualCount": "1,767",
"ActualValue": "1767"
},
{
"Value": "ME",
"Count": "1,710",
"ActualCount": "1,710",
"ActualValue": "1710"
},
{
"Value": "ND",
"Count": "1,667",
"ActualCount": "1,667",
"ActualValue": "1667"
},
{
"Value": "VT",
"Count": "1,344",
"ActualCount": "1,344",
"ActualValue": "1344"
},
{
"Value": "VI",
"Count": "881",
"ActualCount": "881",
"ActualValue": "881"
},
{
"Value": "GU",
"Count": "684",
"ActualCount": "684",
"ActualValue": "684"
},
{
"Value": "ON",
"Count": "577",
"ActualCount": "577",
"ActualValue": "577"
},
{
"Value": "FL?",
"Count": "122",
"ActualCount": "122",
"ActualValue": "122"
},
{
"Value": "MP",
"Count": "105",
"ActualCount": "105",
"ActualValue": "105"
},
{
"Value": "INDIANA",
"Count": "87",
"ActualCount": "87",
"ActualValue": "87"
},
{
"Value": "QC",
"Count": "87",
"ActualCount": "87",
"ActualValue": "87"
},
{
"Value": "AB",
"Count": "79",
"ActualCount": "79",
"ActualValue": "79"
},
{
"Value": "BC",
"Count": "76",
"ActualCount": "76",
"ActualValue": "76"
},
{
"Value": "AS",
"Count": "52",
"ActualCount": "52",
"ActualValue": "52"
},
{
"Value": "SUITE",
"Count": "36",
"ActualCount": "36",
"ActualValue": "36"
},
{
"Value": "DIST. OF COLUMBIA",
"Count": "29",
"ActualCount": "29",
"ActualValue": "29"
},
{
"Value": "MB",
"Count": "21",
"ActualCount": "21",
"ActualValue": "21"
},
{
"Value": "STE.",
"Count": "15",
"ActualCount": "15",
"ActualValue": "15"
},
{
"Value": "California",
"Count": "23",
"ActualCount": "23",
"ActualValue": "23"
},
{
"Value": "STE",
"Count": "13",
"ActualCount": "13",
"ActualValue": "13"
},
{
"Value": "NEW YORK",
"Count": "12",
"ActualCount": "12",
"ActualValue": "12"
},
{
"Value": "UNIT",
"Count": "11",
"ActualCount": "11",
"ActualValue": "11"
},
{
"Value": "CA.",
"Count": "10",
"ActualCount": "10",
"ActualValue": "10"
},
{
"Value": "FLORIDA",
"Count": "10",
"ActualCount": "10",
"ActualValue": "10"
},
{
"Value": "SK",
"Count": "10",
"ActualCount": "10",
"ActualValue": "10"
},
{
"Value": "AVE.",
"Count": "8",
"ActualCount": "8",
"ActualValue": "8"
},
{
"Value": "AVENUE",
"Count": "8",
"ActualCount": "8",
"ActualValue": "8"
},
{
"Value": "BLVD.",
"Count": "8",
"ActualCount": "8",
"ActualValue": "8"
},
{
"Value": "MASSACHUSETTS",
"Count": "8",
"ActualCount": "8",
"ActualValue": "8"
},
{
"Value": "NS",
"Count": "8",
"ActualCount": "8",
"ActualValue": "8"
},
{
"Value": "GEORGIA",
"Count": "7",
"ActualCount": "7",
"ActualValue": "7"
},
{
"Value": "NEW JERSEY",
"Count": "7",
"ActualCount": "7",
"ActualValue": "7"
},
{
"Value": "Ontario",
"Count": "7",
"ActualCount": "7",
"ActualValue": "7"
},
{
"Value": "PENNSYLVANIA",
"Count": "7",
"ActualCount": "7",
"ActualValue": "7"
},
{
"Value": "AVE",
"Count": "6",
"ActualCount": "6",
"ActualValue": "6"
},
{
"Value": "MARYLAND",
"Count": "6",
"ActualCount": "6",
"ActualValue": "6"
},
{
"Value": "BLVD",
"Count": "5",
"ActualCount": "5",
"ActualValue": "5"
},
{
"Value": "DRIVE",
"Count": "5",
"ActualCount": "5",
"ActualValue": "5"
},
{
"Value": "ST",
"Count": "5",
"ActualCount": "5",
"ActualValue": "5"
},
{
"Value": "ST.",
"Count": "5",
"ActualCount": "5",
"ActualValue": "5"
},
{
"Value": "STREET",
"Count": "5",
"ActualCount": "5",
"ActualValue": "5"
},
{
"Value": "TEXAS",
"Count": "5",
"ActualCount": "5",
"ActualValue": "5"
},
{
"Value": "ILLINOIS",
"Count": "4",
"ActualCount": "4",
"ActualValue": "4"
},
{
"Value": "5TH",
"Count": "3",
"ActualCount": "3",
"ActualValue": "3"
},
{
"Value": "British Columbia",
"Count": "3",
"ActualCount": "3",
"ActualValue": "3"
},
{
"Value": "D.",
"Count": "3",
"ActualCount": "3",
"ActualValue": "3"
},
{
"Value": "FM",
"Count": "3",
"ActualCount": "3",
"ActualValue": "3"
},
{
"Value": "GROVE",
"Count": "3",
"ActualCount": "3",
"ActualValue": "3"
}
],
"NAICS": [
{
"Value": "ADMINISTRATIVE MANAGEMENT AND GENERAL MANAGEMENT CONSULTING SERVICES - 541611",
"Count": "5000+",
"ActualCount": "52,741",
"ActualValue": "52741"
},
{
"Value": "ENGINEERING SERVICES - 541330",
"Count": "5000+",
"ActualCount": "40,218",
"ActualValue": "40218"
},
{
"Value": "CUSTOM COMPUTER PROGRAMMING SERVICES - 541511",
"Count": "5000+",
"ActualCount": "40,109",
"ActualValue": "40109"
},
{
"Value": "COMPUTER SYSTEMS DESIGN SERVICES - 541512",
"Count": "5000+",
"ActualCount": "39,572",
"ActualValue": "39572"
},
{
"Value": "COMMERCIAL AND INSTITUTIONAL BUILDING CONSTRUCTION - 236220",
"Count": "5000+",
"ActualCount": "34,878",
"ActualValue": "34878"
},
{
"Value": "OTHER SCIENTIFIC AND TECHNICAL CONSULTING SERVICES - 541690",
"Count": "5000+",
"ActualCount": "34,190",
"ActualValue": "34190"
},
{
"Value": "OTHER MANAGEMENT CONSULTING SERVICES - 541618",
"Count": "5000+",
"ActualCount": "33,878",
"ActualValue": "33878"
},
{
"Value": "OTHER COMPUTER RELATED SERVICES - 541519",
"Count": "5000+",
"ActualCount": "31,729",
"ActualValue": "31729"
},
{
"Value": "ALL OTHER PROFESSIONAL, SCIENTIFIC, AND TECHNICAL SERVICES - 541990",
"Count": "5000+",
"ActualCount": "27,377",
"ActualValue": "27377"
},
{
"Value": "ALL OTHER SPECIALTY TRADE CONTRACTORS - 238990",
"Count": "5000+",
"ActualCount": "24,496",
"ActualValue": "24496"
},
{
"Value": "ELECTRICAL CONTRACTORS AND OTHER WIRING INSTALLATION CONTRACTORS - 238210",
"Count": "5000+",
"ActualCount": "23,466",
"ActualValue": "23466"
},
{
"Value": "PROFESSIONAL AND MANAGEMENT DEVELOPMENT TRAINING - 611430",
"Count": "5000+",
"ActualCount": "21,305",
"ActualValue": "21305"
},
{
"Value": "HIGHWAY, STREET, AND BRIDGE CONSTRUCTION - 237310",
"Count": "5000+",
"ActualCount": "19,936",
"ActualValue": "19936"
},
{
"Value": "COMPUTER FACILITIES MANAGEMENT SERVICES - 541513",
"Count": "5000+",
"ActualCount": "19,009",
"ActualValue": "19009"
},
{
"Value": "INDUSTRIAL BUILDING CONSTRUCTION - 236210",
"Count": "5000+",
"ActualCount": "18,931",
"ActualValue": "18931"
},
{
"Value": "RESIDENTIAL REMODELERS - 236118",
"Count": "5000+",
"ActualCount": "17,750",
"ActualValue": "17750"
},
{
"Value": "SITE PREPARATION CONTRACTORS - 238910",
"Count": "5000+",
"ActualCount": "17,708",
"ActualValue": "17708"
},
{
"Value": "MARKETING CONSULTING SERVICES - 541613",
"Count": "5000+",
"ActualCount": "17,680",
"ActualValue": "17680"
},
{
"Value": "DATA PROCESSING, HOSTING, AND RELATED SERVICES - 518210",
"Count": "5000+",
"ActualCount": "17,195",
"ActualValue": "17195"
},
{
"Value": "WATER AND SEWER LINE AND RELATED STRUCTURES CONSTRUCTION - 237110",
"Count": "5000+",
"ActualCount": "16,957",
"ActualValue": "16957"
},
{
"Value": "PLUMBING, HEATING, AND AIR CONDITIONING CONTRACTORS - 238220",
"Count": "5000+",
"ActualCount": "16,209",
"ActualValue": "16209"
},
{
"Value": "HUMAN RESOURCES CONSULTING SERVICES - 541612",
"Count": "5000+",
"ActualCount": "16,114",
"ActualValue": "16114"
},
{
"Value": "OTHER HEAVY AND CIVIL ENGINEERING CONSTRUCTION - 237990",
"Count": "5000+",
"ActualCount": "15,910",
"ActualValue": "15910"
},
{
"Value": "RESEARCH AND DEVELOPMENT IN THE PHYSICAL, ENGINEERING, AND LIFE SCIENCES (EXCEPT NANOTECHNOLOGY AND BIOTECHNOLOGY) 11 - 541715",
"Count": "5000+",
"ActualCount": "15,815",
"ActualValue": "15815"
},
{
"Value": "JANITORIAL SERVICES - 561720",
"Count": "5000+",
"ActualCount": "15,208",
"ActualValue": "15208"
},
{
"Value": "PROCESS, PHYSICAL DISTRIBUTION, AND LOGISTICS CONSULTING SERVICES - 541614",
"Count": "5000+",
"ActualCount": "14,594",
"ActualValue": "14594"
},
{
"Value": "ENVIRONMENTAL CONSULTING SERVICES - 541620",
"Count": "5000+",
"ActualCount": "14,018",
"ActualValue": "14018"
},
{
"Value": "POURED CONCRETE FOUNDATION AND STRUCTURE CONTRACTORS - 238110",
"Count": "5000+",
"ActualCount": "13,552",
"ActualValue": "13552"
},
{
"Value": "LANDSCAPING SERVICES - 561730",
"Count": "5000+",
"ActualCount": "13,411",
"ActualValue": "13411"
},
{
"Value": "SOFTWARE PUBLISHERS - 511210",
"Count": "5000+",
"ActualCount": "13,008",
"ActualValue": "13008"
},
{
"Value": "NEW SINGLE FAMILY HOUSING CONSTRUCTION (EXCEPT FOR SALE BUILDERS) - 236115",
"Count": "5000+",
"ActualCount": "12,945",
"ActualValue": "12945"
},
{
"Value": "RESEARCH AND TECHNOLOGY IN NANOTECHNOLOGY11 - 541713",
"Count": "5000+",
"ActualCount": "12,070",
"ActualValue": "12070"
},
{
"Value": "NEW MULTIFAMILY HOUSING CONSTRUCTION (EXCEPT FOR SALE BUILDERS) - 236116",
"Count": "5000+",
"ActualCount": "11,947",
"ActualValue": "11947"
},
{
"Value": "GRAPHIC DESIGN SERVICES - 541430",
"Count": "5000+",
"ActualCount": "11,709",
"ActualValue": "11709"
},
{
"Value": "EDUCATIONAL SUPPORT SERVICES - 611710",
"Count": "5000+",
"ActualCount": "11,508",
"ActualValue": "11508"
},
{
"Value": "MEDICAL, DENTAL, AND HOSPITAL EQUIPMENT AND SUPPLIES MERCHANT WHOLESALERS - 423450",
"Count": "5000+",
"ActualCount": "10,887",
"ActualValue": "10887"
},
{
"Value": "PAINTING AND WALL COVERING CONTRACTORS - 238320",
"Count": "5000+",
"ActualCount": "10,834",
"ActualValue": "10834"
},
{
"Value": "FACILITIES SUPPORT SERVICES - 561210",
"Count": "5000+",
"ActualCount": "10,513",
"ActualValue": "10513"
},
{
"Value": "OFFICE ADMINISTRATIVE SERVICES - 561110",
"Count": "5000+",
"ActualCount": "10,503",
"ActualValue": "10503"
},
{
"Value": "TEMPORARY HELP SERVICES - 561320",
"Count": "5000+",
"ActualCount": "10,466",
"ActualValue": "10466"
},
{
"Value": "SPECIALIZED FREIGHT (EXCEPT USED GOODS) TRUCKING, LOCAL - 484220",
"Count": "5000+",
"ActualCount": "10,422",
"ActualValue": "10422"
},
{
"Value": "ROOFING CONTRACTORS - 238160",
"Count": "5000+",
"ActualCount": "10,237",
"ActualValue": "10237"
},
{
"Value": "POWER AND COMMUNICATION LINE AND RELATED STRUCTURES CONSTRUCTION - 237130",
"Count": "5000+",
"ActualCount": "10,060",
"ActualValue": "10060"
},
{
"Value": "COMPUTER TRAINING - 611420",
"Count": "5000+",
"ActualCount": "9,812",
"ActualValue": "9812"
},
{
"Value": "LESSORS OF NONRESIDENTIAL BUILDINGS (EXCEPT MINIWAREHOUSES) - 531120",
"Count": "5000+",
"ActualCount": "9,445",
"ActualValue": "9445"
},
{
"Value": "ALL OTHER SUPPORT SERVICES - 561990",
"Count": "5000+",
"ActualCount": "9,295",
"ActualValue": "9295"
},
{
"Value": "GENERAL FREIGHT TRUCKING, LOCAL - 484110",
"Count": "5000+",
"ActualCount": "9,204",
"ActualValue": "9204"
},
{
"Value": "FRAMING CONTRACTORS - 238130",
"Count": "5000+",
"ActualCount": "9,106",
"ActualValue": "9106"
},
{
"Value": "DRYWALL AND INSULATION CONTRACTORS - 238310",
"Count": "5000+",
"ActualCount": "8,821",
"ActualValue": "8821"
},
{
"Value": "OTHER FOUNDATION, STRUCTURE, AND BUILDING EXTERIOR CONTRACTORS - 238190",
"Count": "5000+",
"ActualCount": "8,818",
"ActualValue": "8818"
},
{
"Value": "OTHER SERVICES TO BUILDINGS AND DWELLINGS - 561790",
"Count": "5000+",
"ActualCount": "8,502",
"ActualValue": "8502"
},
{
"Value": "COMPUTER AND COMPUTER PERIPHERAL EQUIPMENT AND SOFTWARE MERCHANT WHOLESALERS - 423430",
"Count": "5000+",
"ActualCount": "8,235",
"ActualValue": "8235"
},
{
"Value": "STRUCTURAL STEEL AND PRECAST CONCRETE CONTRACTORS - 238120",
"Count": "5000+",
"ActualCount": "8,040",
"ActualValue": "8040"
},
{
"Value": "ARCHITECTURAL SERVICES - 541310",
"Count": "5000+",
"ActualCount": "7,979",
"ActualValue": "7979"
},
{
"Value": "REMEDIATION SERVICES - 562910",
"Count": "5000+",
"ActualCount": "7,964",
"ActualValue": "7964"
},
{
"Value": "MACHINE SHOPS - 332710",
"Count": "5000+",
"ActualCount": "7,831",
"ActualValue": "7831"
},
{
"Value": "MASONRY CONTRACTORS - 238140",
"Count": "5000+",
"ActualCount": "7,658",
"ActualValue": "7658"
},
{
"Value": "HOTELS (EXCEPT CASINO HOTELS) AND MOTELS - 721110",
"Count": "5000+",
"ActualCount": "7,629",
"ActualValue": "7629"
},
{
"Value": "COMMERCIAL AND INDUSTRIAL MACHINERY AND EQUIPMENT (EXCEPT AUTOMOTIVE AND ELECTRONIC) REPAIR AND MAINTENANCE - 811310",
"Count": "5000+",
"ActualCount": "7,541",
"ActualValue": "7541"
},
{
"Value": "OTHER BUILDING FINISHING CONTRACTORS - 238390",
"Count": "5000+",
"ActualCount": "7,108",
"ActualValue": "7108"
},
{
"Value": "ALL OTHER INFORMATION SERVICES - 519190",
"Count": "5000+",
"ActualCount": "6,986",
"ActualValue": "6986"
},
{
"Value": "ALL OTHER MISCELLANEOUS FABRICATED METAL PRODUCT MANUFACTURING - 332999",
"Count": "5000+",
"ActualCount": "6,972",
"ActualValue": "6972"
},
{
"Value": "OTHER BUILDING EQUIPMENT CONTRACTORS - 238290",
"Count": "5000+",
"ActualCount": "6,958",
"ActualValue": "6958"
},
{
"Value": "FLOORING CONTRACTORS - 238330",
"Count": "5000+",
"ActualCount": "6,922",
"ActualValue": "6922"
},
{
"Value": "TESTING LABORATORIES - 541380",
"Count": "5000+",
"ActualCount": "6,782",
"ActualValue": "6782"
},
{
"Value": "GENERAL FREIGHT TRUCKING, LONG DISTANCE, TRUCKLOAD - 484121",
"Count": "5000+",
"ActualCount": "6,659",
"ActualValue": "6659"
},
{
"Value": "ELECTRICAL APPARATUS AND EQUIPMENT, WIRING SUPPLIES, AND RELATED EQUIPMENT MERCHANT WHOLESALERS - 423610",
"Count": "5000+",
"ActualCount": "6,628",
"ActualValue": "6628"
},
{
"Value": "SURVEYING AND MAPPING (EXCEPT GEOPHYSICAL) SERVICES - 541370",
"Count": "5000+",
"ActualCount": "6,609",
"ActualValue": "6609"
},
{
"Value": "FINISH CARPENTRY CONTRACTORS - 238350",
"Count": "5000+",
"ActualCount": "6,504",
"ActualValue": "6504"
},
{
"Value": "SUPPORT ACTIVITIES FOR FORESTRY - 115310",
"Count": "5000+",
"ActualCount": "6,306",
"ActualValue": "6306"
},
{
"Value": "RESEARCH AND DEVELOPMENT IN THE SOCIAL SCIENCES AND HUMANITIES - 541720",
"Count": "5000+",
"ActualCount": "6,253",
"ActualValue": "6253"
},
{
"Value": "SURGICAL APPLIANCE AND SUPPLIES MANUFACTURING - 339113",
"Count": "5000+",
"ActualCount": "6,160",
"ActualValue": "6160"
},
{
"Value": "SECURITY SYSTEMS SERVICES (EXCEPT LOCKSMITHS) - 561621",
"Count": "5000+",
"ActualCount": "6,137",
"ActualValue": "6137"
},
{
"Value": "INDUSTRIAL MACHINERY AND EQUIPMENT MERCHANT WHOLESALERS - 423830",
"Count": "5000+",
"ActualCount": "5,975",
"ActualValue": "5975"
},
{
"Value": "ALL OTHER MISCELLANEOUS SCHOOLS AND INSTRUCTION - 611699",
"Count": "5000+",
"ActualCount": "5,940",
"ActualValue": "5940"
},
{
"Value": "EMPLOYMENT PLACEMENT AGENCIES - 561311",
"Count": "5000+",
"ActualCount": "5,875",
"ActualValue": "5875"
},
{
"Value": "OIL AND GAS PIPELINE AND RELATED STRUCTURES CONSTRUCTION - 237120",
"Count": "5000+",
"ActualCount": "5,756",
"ActualValue": "5756"
},
{
"Value": "DRAFTING SERVICES - 541340",
"Count": "5000+",
"ActualCount": "5,704",
"ActualValue": "5704"
},
{
"Value": "ADVERTISING AGENCIES - 541810",
"Count": "5000+",
"ActualCount": "5,579",
"ActualValue": "5579"
},
{
"Value": "INVESTIGATION SERVICES - 561611",
"Count": "5000+",
"ActualCount": "5,535",
"ActualValue": "5535"
},
{
"Value": "INDUSTRIAL SUPPLIES MERCHANT WHOLESALERS - 423840",
"Count": "5000+",
"ActualCount": "5,467",
"ActualValue": "5467"
},
{
"Value": "OTHER ACCOUNTING SERVICES - 541219",
"Count": "5000+",
"ActualCount": "5,458",
"ActualValue": "5458"
},
{
"Value": "WATER SUPPLY AND IRRIGATION SYSTEMS - 221310",
"Count": "5000+",
"ActualCount": "5,398",
"ActualValue": "5398"
},
{
"Value": "OTHER SPECIALIZED DESIGN SERVICES - 541490",
"Count": "5000+",
"ActualCount": "5,336",
"ActualValue": "5336"
},
{
"Value": "NEW HOUSING OPERATIVE BUILDERS - 236117",
"Count": "5000+",
"ActualCount": "5,282",
"ActualValue": "5282"
},
{
"Value": "INTERNET PUBLISHING AND BROADCASTING AND WEB SEARCH PORTALS - 519130",
"Count": "5000+",
"ActualCount": "5,280",
"ActualValue": "5280"
},
{
"Value": "MOTION PICTURE AND VIDEO PRODUCTION - 512110",
"Count": "5000+",
"ActualCount": "5,264",
"ActualValue": "5264"
},
{
"Value": "BUILDING INSPECTION SERVICES - 541350",
"Count": "5000+",
"ActualCount": "5,246",
"ActualValue": "5246"
},
{
"Value": "RESEARCH AND TECHNOLOGY IN BIOTECHNOLOGY (EXCEPT NANOBIOTECHNOLOGY)11 - 541714",
"Count": "5000+",
"ActualCount": "5,223",
"ActualValue": "5223"
},
{
"Value": "ALL OTHER TELECOMMUNICATIONS - 517919",
"Count": "5000+",
"ActualCount": "5,187",
"ActualValue": "5187"
},
{
"Value": "ALL OTHER BUSINESS SUPPORT SERVICES - 561499",
"Count": "5000+",
"ActualCount": "5,177",
"ActualValue": "5177"
},
{
"Value": "SECURITY GUARDS AND PATROL SERVICES - 561612",
"Count": "5000+",
"ActualCount": "5,139",
"ActualValue": "5139"
},
{
"Value": "COMMERCIAL PRINTING (EXCEPT SCREEN AND BOOKS) - 323111",
"Count": "5000+",
"ActualCount": "5,129",
"ActualValue": "5129"
},
{
"Value": "PUBLIC RELATIONS AGENCIES - 541820",
"Count": "5000+",
"ActualCount": "5,025",
"ActualValue": "5025"
},
{
"Value": "SIDING CONTRACTORS - 238170",
"Count": "4,998",
"ActualCount": "4,998",
"ActualValue": "4998"
},
{
"Value": "INDEPENDENT ARTISTS, WRITERS, AND PERFORMERS - 711510",
"Count": "4,981",
"ActualCount": "4,981",
"ActualValue": "4981"
},
{
"Value": "SPECIALIZED FREIGHT (EXCEPT USED GOODS) TRUCKING, LONG DISTANCE - 484230",
"Count": "4,962",
"ActualCount": "4,962",
"ActualValue": "4962"
},
{
"Value": "OTHER ELECTRONIC PARTS AND EQUIPMENT MERCHANT WHOLESALERS - 423690",
"Count": "4,843",
"ActualCount": "4,843",
"ActualValue": "4843"
},
{
"Value": "COMPUTER AND OFFICE MACHINE REPAIR AND MAINTENANCE - 811212",
"Count": "4,802",
"ActualCount": "4,802",
"ActualValue": "4802"
},
{
"Value": "RADIO AND TELEVISION BROADCASTING AND WIRELESS COMMUNICATIONS EQUIPMENT MANUFACTURING - 334220",
"Count": "4,738",
"ActualCount": "4,738",
"ActualValue": "4738"
}
],
"SIC": [
{
"Value": "BUSINESS SERVICES, NOT ELSEWHERE CLASSIFIED - 7389",
"Count": "5000+",
"ActualCount": "20,964",
"ActualValue": "20964"
},
{
"Value": "MANAGEMENT CONSULTING SERVICES - 8742",
"Count": "5000+",
"ActualCount": "17,362",
"ActualValue": "17362"
},
{
"Value": "BUSINESS CONSULTING, NOT ELSEWHERE CLASSIFIED - 8748",
"Count": "5000+",
"ActualCount": "15,204",
"ActualValue": "15204"
},
{
"Value": "ENGINEERING SERVICES - 8711",
"Count": "5000+",
"ActualCount": "15,028",
"ActualValue": "15028"
},
{
"Value": "CUSTOM COMPUTER PROGRAMMING SERVICES - 7371",
"Count": "5000+",
"ActualCount": "12,819",
"ActualValue": "12819"
},
{
"Value": "OPERATIVE BUILDERS - 1531",
"Count": "5000+",
"ActualCount": "12,797",
"ActualValue": "12797"
},
{
"Value": "COMPUTER INTEGRATED SYSTEMS DESIGN - 7373",
"Count": "5000+",
"ActualCount": "12,665",
"ActualValue": "12665"
},
{
"Value": "SPECIAL TRADE CONTRACTORS, NOT ELSEWHERE CLASSIFIED - 1799",
"Count": "5000+",
"ActualCount": "10,456",
"ActualValue": "10456"
},
{
"Value": "COMPUTER RELATED SERVICES, NOT ELSEWHERE CLASSIFIED - 7379",
"Count": "5000+",
"ActualCount": "10,001",
"ActualValue": "10001"
},
{
"Value": "WATER, SEWER, AND UTILITY LINES - 1623",
"Count": "5000+",
"ActualCount": "8,740",
"ActualValue": "8740"
},
{
"Value": "SCHOOLS AND EDUCATIONAL SERVICES, NOT ELSEWHERE CLASSIFIED - 8299",
"Count": "5000+",
"ActualCount": "8,151",
"ActualValue": "8151"
},
{
"Value": "ELECTRICAL WORK - 1731",
"Count": "5000+",
"ActualCount": "8,061",
"ActualValue": "8061"
},
{
"Value": "SERVICES, NOT ELSEWHERE CLASSIFIED - 8999",
"Count": "5000+",
"ActualCount": "7,852",
"ActualValue": "7852"
},
{
"Value": "REPAIR SERVICES, NOT ELSEWHERE CLASSIFIED - 7699",
"Count": "5000+",
"ActualCount": "7,786",
"ActualValue": "7786"
},
{
"Value": "INDUSTRIAL BUILDINGS AND WAREHOUSES - 1541",
"Count": "5000+",
"ActualCount": "7,163",
"ActualValue": "7163"
},
{
"Value": "NONCOMMERCIAL RESEARCH ORGANIZATIONS - 8733",
"Count": "5000+",
"ActualCount": "6,908",
"ActualValue": "6908"
},
{
"Value": "HIGHWAY AND STREET CONSTRUCTION - 1611",
"Count": "5000+",
"ActualCount": "6,867",
"ActualValue": "6867"
},
{
"Value": "HEAVY CONSTRUCTION, NOT ELSEWHERE CLASSIFIED - 1629",
"Count": "5000+",
"ActualCount": "6,200",
"ActualValue": "6200"
},
{
"Value": "COMPUTER FACILITIES MANAGEMENT - 7376",
"Count": "5000+",
"ActualCount": "6,096",
"ActualValue": "6096"
},
{
"Value": "HEAVY CONSTRUCTION EQUIPMENT RENTAL - 7353",
"Count": "5000+",
"ActualCount": "5,858",
"ActualValue": "5858"
},
{
"Value": "PLUMBING, HEATING, AIR CONDITIONING - 1711",
"Count": "5000+",
"ActualCount": "5,479",
"ActualValue": "5479"
},
{
"Value": "DATA PROCESSING AND PREPARATION - 7374",
"Count": "5000+",
"ActualCount": "5,160",
"ActualValue": "5160"
},
{
"Value": "LOCAL TRUCKING, WITHOUT STORAGE - 4212",
"Count": "4,900",
"ActualCount": "4,900",
"ActualValue": "4900"
},
{
"Value": "REAL ESTATE AGENTS AND MANAGERS - 6531",
"Count": "4,881",
"ActualCount": "4,881",
"ActualValue": "4881"
},
{
"Value": "CONCRETE WORK - 1771",
"Count": "4,441",
"ActualCount": "4,441",
"ActualValue": "4441"
},
{
"Value": "NONRESIDENTIAL BUILDING OPERATORS - 6512",
"Count": "4,304",
"ActualCount": "4,304",
"ActualValue": "4304"
},
{
"Value": "PREPACKAGED SOFTWARE - 7372",
"Count": "4,246",
"ActualCount": "4,246",
"ActualValue": "4246"
},
{
"Value": "FABRICATED METAL PRODUCTS, NOT ELSEWHERE CLASSIFIED - 3499",
"Count": "4,178",
"ActualCount": "4,178",
"ActualValue": "4178"
},
{
"Value": "BUILDING MAINTENANCE SERVICES, NOT ELSEWHERE CLASSIFIED - 7349",
"Count": "4,029",
"ActualCount": "4,029",
"ActualValue": "4029"
},
{
"Value": "SINGLE FAMILY HOUSING CONSTRUCTION - 1521",
"Count": "4,027",
"ActualCount": "4,027",
"ActualValue": "4027"
},
{
"Value": "CARPENTRY WORK - 1751",
"Count": "3,924",
"ActualCount": "3,924",
"ActualValue": "3924"
},
{
"Value": "RESIDENTIAL CONSTRUCTION, NOT ELSEWHERE CLASSIFIED - 1522",
"Count": "3,897",
"ActualCount": "3,897",
"ActualValue": "3897"
},
{
"Value": "ELECTRONIC PARTS AND EQUIPMENT, NOT ELSEWHERE CLASSIFIED - 5065",
"Count": "3,770",
"ActualCount": "3,770",
"ActualValue": "3770"
},
{
"Value": "INDUSTRIAL MACHINERY, NOT ELSEWHERE CLASSIFIED - 3599",
"Count": "3,527",
"ActualCount": "3,527",
"ActualValue": "3527"
},
{
"Value": "DATA PROCESSING SCHOOLS - 8243",
"Count": "3,477",
"ActualCount": "3,477",
"ActualValue": "3477"
},
{
"Value": "ROOFING, SIDING, AND SHEETMETAL WORK - 1761",
"Count": "3,436",
"ActualCount": "3,436",
"ActualValue": "3436"
},
{
"Value": "COMMERCIAL ART AND GRAPHIC DESIGN - 7336",
"Count": "3,320",
"ActualCount": "3,320",
"ActualValue": "3320"
},
{
"Value": "COMPUTERS, PERIPHERALS, AND SOFTWARE - 5045",
"Count": "3,250",
"ActualCount": "3,250",
"ActualValue": "3250"
},
{
"Value": "ELECTRONIC COMPONENTS, NOT ELSEWHERE CLASSIFIED - 3679",
"Count": "3,152",
"ActualCount": "3,152",
"ActualValue": "3152"
},
{
"Value": "FACILITIES SUPPORT SERVICES - 8744",
"Count": "3,112",
"ActualCount": "3,112",
"ActualValue": "3112"
},
{
"Value": "ARCHITECTURAL SERVICES - 8712",
"Count": "3,055",
"ActualCount": "3,055",
"ActualValue": "3055"
},
{
"Value": "TESTING LABORATORIES - 8734",
"Count": "2,936",
"ActualCount": "2,936",
"ActualValue": "2936"
},
{
"Value": "MEDICAL AND HOSPITAL EQUIPMENT - 5047",
"Count": "2,917",
"ActualCount": "2,917",
"ActualValue": "2917"
},
{
"Value": "SANITARY SERVICES, NOT ELSEWHERE CLASSIFIED - 4959",
"Count": "2,866",
"ActualCount": "2,866",
"ActualValue": "2866"
},
{
"Value": "SURVEYING SERVICES - 8713",
"Count": "2,827",
"ActualCount": "2,827",
"ActualValue": "2827"
},
{
"Value": "LAWN AND GARDEN SERVICES - 0782",
"Count": "2,815",
"ActualCount": "2,815",
"ActualValue": "2815"
},
{
"Value": "OIL AND GAS FIELD SERVICES, NOT ELSEWHERE CLASSIFIED - 1389",
"Count": "2,809",
"ActualCount": "2,809",
"ActualValue": "2809"
},
{
"Value": "MANAGEMENT SERVICES - 8741",
"Count": "2,781",
"ActualCount": "2,781",
"ActualValue": "2781"
},
{
"Value": "ELECTRICAL APPARATUS AND EQUIPMENT - 5063",
"Count": "2,716",
"ActualCount": "2,716",
"ActualValue": "2716"
},
{
"Value": "STRUCTURAL STEEL ERECTION - 1791",
"Count": "2,695",
"ActualCount": "2,695",
"ActualValue": "2695"
},
{
"Value": "INDUSTRIAL MACHINERY AND EQUIPMENT - 5084",
"Count": "2,681",
"ActualCount": "2,681",
"ActualValue": "2681"
},
{
"Value": "FORESTRY SERVICES - 0851",
"Count": "2,637",
"ActualCount": "2,637",
"ActualValue": "2637"
},
{
"Value": "INDIVIDUAL AND FAMILY SERVICES - 8322",
"Count": "2,623",
"ActualCount": "2,623",
"ActualValue": "2623"
},
{
"Value": "EQUIPMENT RENTAL AND LEASING, NOT ELSEWHERE CLASSIFIED - 7359",
"Count": "2,551",
"ActualCount": "2,551",
"ActualValue": "2551"
},
{
"Value": "HELP SUPPLY SERVICES - 7363",
"Count": "2,533",
"ActualCount": "2,533",
"ActualValue": "2533"
},
{
"Value": "COMMUNICATION SERVICES, NOT ELSEWHERE CLASSIFIED - 4899",
"Count": "2,530",
"ActualCount": "2,530",
"ActualValue": "2530"
},
{
"Value": "PAINTING AND PAPER HANGING - 1721",
"Count": "2,484",
"ActualCount": "2,484",
"ActualValue": "2484"
},
{
"Value": "INSTALLING BUILDING EQUIPMENT - 1796",
"Count": "2,410",
"ActualCount": "2,410",
"ActualValue": "2410"
},
{
"Value": "DETECTIVE AND ARMORED CAR SERVICES - 7381",
"Count": "2,400",
"ActualCount": "2,400",
"ActualValue": "2400"
},
{
"Value": "TELEPHONE COMMUNICATION, EXCEPT RADIO - 4813",
"Count": "2,398",
"ActualCount": "2,398",
"ActualValue": "2398"
},
{
"Value": "MASONRY AND OTHER STONEWORK - 1741",
"Count": "2,390",
"ActualCount": "2,390",
"ActualValue": "2390"
},
{
"Value": "INDUSTRIAL SUPPLIES - 5085",
"Count": "2,342",
"ActualCount": "2,342",
"ActualValue": "2342"
},
{
"Value": "MISCELLANEOUS RETAIL STORES, NOT ELSEWHERE CLASSIFIED - 5999",
"Count": "2,170",
"ActualCount": "2,170",
"ActualValue": "2170"
},
{
"Value": "AIRCRAFT PARTS AND EQUIPMENT, NOT ELSEWHERE CLASSIFIED - 3728",
"Count": "2,099",
"ActualCount": "2,099",
"ActualValue": "2099"
},
{
"Value": "RADIO AND T.V. COMMUNICATIONS EQUIPMENT - 3663",
"Count": "2,077",
"ActualCount": "2,077",
"ActualValue": "2077"
},
{
"Value": "MANUFACTURING INDUSTRIES, NOT ELSEWHERE CLASSIFIED - 3999",
"Count": "2,064",
"ActualCount": "2,064",
"ActualValue": "2064"
},
{
"Value": "PLASTERING, DRYWALL, AND INSULATION - 1742",
"Count": "2,010",
"ActualCount": "2,010",
"ActualValue": "2010"
},
{
"Value": "COMMUNICATIONS EQUIPMENT, NOT ELSEWHERE CLASSIFIED - 3669",
"Count": "1,995",
"ActualCount": "1,995",
"ActualValue": "1995"
},
{
"Value": "WATER SUPPLY - 4941",
"Count": "1,969",
"ActualCount": "1,969",
"ActualValue": "1969"
},
{
"Value": "HOTELS AND MOTELS - 7011",
"Count": "1,956",
"ActualCount": "1,956",
"ActualValue": "1956"
},
{
"Value": "LABORATORY APPARATUS AND FURNITURE - 3821",
"Count": "1,955",
"ActualCount": "1,955",
"ActualValue": "1955"
},
{
"Value": "SECURITY SYSTEMS SERVICES - 7382",
"Count": "1,950",
"ActualCount": "1,950",
"ActualValue": "1950"
},
{
"Value": "ACCOUNTING, AUDITING, AND BOOKKEEPING - 8721",
"Count": "1,873",
"ActualCount": "1,873",
"ActualValue": "1873"
},
{
"Value": "SUBDIVIDERS AND DEVELOPERS, NOT ELSEWHERE CLASSIFIED - 6552",
"Count": "1,849",
"ActualCount": "1,849",
"ActualValue": "1849"
},
{
"Value": "FLOOR LAYING AND FLOOR WORK, NOT ELSEWHERE CLASSIFIED - 1752",
"Count": "1,843",
"ActualCount": "1,843",
"ActualValue": "1843"
},
{
"Value": "SHEET METALWORK - 3444",
"Count": "1,786",
"ActualCount": "1,786",
"ActualValue": "1786"
},
{
"Value": "SCREW MACHINE PRODUCTS - 3451",
"Count": "1,757",
"ActualCount": "1,757",
"ActualValue": "1757"
},
{
"Value": "PLASTICS PRODUCTS, NOT ELSEWHERE CLASSIFIED - 3089",
"Count": "1,756",
"ActualCount": "1,756",
"ActualValue": "1756"
},
{
"Value": "MEASURING AND CONTROLLING DEVICES, NOT ELSEWHERE CLASSIFIED - 3829",
"Count": "1,739",
"ActualCount": "1,739",
"ActualValue": "1739"
},
{
"Value": "COMMERCIAL PHYSICAL RESEARCH - 8731",
"Count": "1,720",
"ActualCount": "1,720",
"ActualValue": "1720"
},
{
"Value": "COMMERCIAL PRINTING, LITHOGRAPHIC - 2752",
"Count": "1,661",
"ActualCount": "1,661",
"ActualValue": "1661"
},
{
"Value": "ELECTRICAL INDUSTRIAL APPARATUS, NOT ELSEWHERE CLASSIFIED - 3629",
"Count": "1,642",
"ActualCount": "1,642",
"ActualValue": "1642"
},
{
"Value": "ELECTRONIC COMPUTERS - 3571",
"Count": "1,642",
"ActualCount": "1,642",
"ActualValue": "1642"
},
{
"Value": "STATIONERY AND OFFICE SUPPLIES - 5112",
"Count": "1,620",
"ActualCount": "1,620",
"ActualValue": "1620"
},
{
"Value": "OFFICES OF HEALTH PRACTITIONER - 8049",
"Count": "1,577",
"ActualCount": "1,577",
"ActualValue": "1577"
},
{
"Value": "FABRICATED STRUCTURAL METAL - 3441",
"Count": "1,563",
"ActualCount": "1,563",
"ActualValue": "1563"
},
{
"Value": "GENERAL WAREHOUSING AND STORAGE - 4225",
"Count": "1,541",
"ActualCount": "1,541",
"ActualValue": "1541"
},
{
"Value": "FABRICATED PLATE WORK (BOILER SHOP) - 3443",
"Count": "1,525",
"ActualCount": "1,525",
"ActualValue": "1525"
},
{
"Value": "OFFICES AND CLINICS OF MEDICAL DOCTORS - 8011",
"Count": "1,506",
"ActualCount": "1,506",
"ActualValue": "1506"
},
{
"Value": "TOP AND BODY REPAIR AND PAINT SHOPS - 7532",
"Count": "1,503",
"ActualCount": "1,503",
"ActualValue": "1503"
},
{
"Value": "JOB TRAINING AND RELATED SERVICES - 8331",
"Count": "1,473",
"ActualCount": "1,473",
"ActualValue": "1473"
},
{
"Value": "TRUCKING, EXCEPT LOCAL - 4213",
"Count": "1,463",
"ActualCount": "1,463",
"ActualValue": "1463"
},
{
"Value": "SEARCH AND NAVIGATION EQUIPMENT - 3812",
"Count": "1,434",
"ActualCount": "1,434",
"ActualValue": "1434"
},
{
"Value": "ADVERTISING, NOT ELSEWHERE CLASSIFIED - 7319",
"Count": "1,432",
"ActualCount": "1,432",
"ActualValue": "1432"
},
{
"Value": "LANDSCAPE COUNSELING AND PLANNING - 0781",
"Count": "1,430",
"ActualCount": "1,430",
"ActualValue": "1430"
},
{
"Value": "BRICK, STONE, AND RELATED MATERIAL - 5032",
"Count": "1,428",
"ActualCount": "1,428",
"ActualValue": "1428"
},
{
"Value": "EMPLOYMENT AGENCIES - 7361",
"Count": "1,414",
"ActualCount": "1,414",
"ActualValue": "1414"
},
{
"Value": "PROFESSIONAL EQUIPMENT, NOT ELSEWHERE CLASSIFIED - 5049",
"Count": "1,413",
"ActualCount": "1,413",
"ActualValue": "1413"
},
{
"Value": "PROCESS CONTROL INSTRUMENTS - 3823",
"Count": "1,392",
"ActualCount": "1,392",
"ActualValue": "1392"
},
{
"Value": "HARDWARE - 5072",
"Count": "1,378",
"ActualCount": "1,378",
"ActualValue": "1378"
}
],
"Revenue": [
{
"Value": "less than $500K",
"Count": "5000+",
"ActualCount": "73,279",
"ActualValue": "73279"
},
{
"Value": "$1M-10M",
"Count": "5000+",
"ActualCount": "59,236",
"ActualValue": "59236"
},
{
"Value": "$500K-1M",
"Count": "5000+",
"ActualCount": "22,644",
"ActualValue": "22644"
},
{
"Value": "$10M-50M",
"Count": "5000+",
"ActualCount": "13,936",
"ActualValue": "13936"
},
{
"Value": "$50M-$100M",
"Count": "1,575",
"ActualCount": "1,575",
"ActualValue": "1575"
},
{
"Value": "$100M-500M",
"Count": "768",
"ActualCount": "768",
"ActualValue": "768"
},
{
"Value": "$500M-1B",
"Count": "95",
"ActualCount": "95",
"ActualValue": "95"
},
{
"Value": "$1B-10B",
"Count": "81",
"ActualCount": "81",
"ActualValue": "81"
},
{
"Value": "$10B-50B",
"Count": "12",
"ActualCount": "12",
"ActualValue": "12"
},
{
"Value": "$50B+",
"Count": "7",
"ActualCount": "7",
"ActualValue": "7"
},
{
"Value": "1.1111111111111111e+172",
"Count": "2",
"ActualCount": "2",
"ActualValue": "2"
},
{
"Value": "123465789123465789",
"Count": "1",
"ActualCount": "1",
"ActualValue": "1"
},
{
"Value": "527000000000",
"Count": "1",
"ActualCount": "1",
"ActualValue": "1"
},
{
"Value": "900000000000",
"Count": "1",
"ActualCount": "1",
"ActualValue": "1"
}
],
"Employees": [
{
"Value": "1-10",
"Count": "5000+",
"ActualCount": "93,296",
"ActualValue": "93296"
},
{
"Value": "11-50",
"Count": "5000+",
"ActualCount": "58,277",
"ActualValue": "58277"
},
{
"Value": "51-200",
"Count": "5000+",
"ActualCount": "14,520",
"ActualValue": "14520"
},
{
"Value": "201-500",
"Count": "2,399",
"ActualCount": "2,399",
"ActualValue": "2399"
},
{
"Value": "1,001-5,000",
"Count": "519",
"ActualCount": "519",
"ActualValue": "519"
},
{
"Value": "501-1,000",
"Count": "427",
"ActualCount": "427",
"ActualValue": "427"
},
{
"Value": "10,000+",
"Count": "38",
"ActualCount": "38",
"ActualValue": "38"
},
{
"Value": "5,001-10,000",
"Count": "18",
"ActualCount": "18",
"ActualValue": "18"
}
],
"DiversityCategory": [
{
"Value": "SBE",
"Count": "5000+",
"ActualCount": "528,102",
"ActualValue": "528102"
},
{
"Value": "SC-SDB",
"Count": "5000+",
"ActualCount": "208,094",
"ActualValue": "208094"
},
{
"Value": "MBE",
"Count": "5000+",
"ActualCount": "203,525",
"ActualValue": "203525"
},
{
"Value": "WBE",
"Count": "5000+",
"ActualCount": "196,085",
"ActualValue": "196085"
},
{
"Value": "WOSB",
"Count": "5000+",
"ActualCount": "111,452",
"ActualValue": "111452"
},
{
"Value": "VET",
"Count": "5000+",
"ActualCount": "75,709",
"ActualValue": "75709"
},
{
"Value": "DBE",
"Count": "5000+",
"ActualCount": "54,006",
"ActualValue": "54006"
},
{
"Value": "EDWOSB",
"Count": "5000+",
"ActualCount": "43,266",
"ActualValue": "43266"
},
{
"Value": "SDVET",
"Count": "5000+",
"ActualCount": "40,021",
"ActualValue": "40021"
},
{
"Value": "DISABLED",
"Count": "5000+",
"ActualCount": "14,296",
"ActualValue": "14296"
},
{
"Value": "HUBZONE",
"Count": "5000+",
"ActualCount": "6,577",
"ActualValue": "6577"
},
{
"Value": "8A",
"Count": "5000+",
"ActualCount": "6,412",
"ActualValue": "6412"
},
{
"Value": "ANC",
"Count": "3,836",
"ActualCount": "3,836",
"ActualValue": "3836"
},
{
"Value": "ACDBE",
"Count": "3,492",
"ActualCount": "3,492",
"ActualValue": "3492"
},
{
"Value": "EDGE",
"Count": "2,078",
"ActualCount": "2,078",
"ActualValue": "2078"
},
{
"Value": "LGBT",
"Count": "1,027",
"ActualCount": "1,027",
"ActualValue": "1027"
},
{
"Value": "ABILITYONE",
"Count": "465",
"ActualCount": "465",
"ActualValue": "465"
},
{
"Value": "SDB",
"Count": "416",
"ActualCount": "416",
"ActualValue": "416"
},
{
"Value": "SMLSME",
"Count": "185",
"ActualCount": "185",
"ActualValue": "185"
},
{
"Value": "HBCU",
"Count": "141",
"ActualCount": "141",
"ActualValue": "141"
},
{
"Value": "MEDSME",
"Count": "56",
"ActualCount": "56",
"ActualValue": "56"
},
{
"Value": "MICSME",
"Count": "37",
"ActualCount": "37",
"ActualValue": "37"
},
{
"Value": "PUC-LBE",
"Count": "10",
"ActualCount": "10",
"ActualValue": "10"
},
{
"Value": "SME",
"Count": "4",
"ActualCount": "4",
"ActualValue": "4"
},
{
"Value": "Aboriginal",
"Count": "1",
"ActualCount": "1",
"ActualValue": "1"
}
],
"SustainabilityCategory": [
{
"Value": "LOCAL",
"Count": "498",
"ActualCount": "498",
"ActualValue": "498"
}
],
"Ethnicity": [
{
"Value": "AFRICAN AMERICAN",
"Count": "5000+",
"ActualCount": "85,205",
"ActualValue": "85205"
},
{
"Value": "HISPANIC AMERICAN",
"Count": "5000+",
"ActualCount": "45,001",
"ActualValue": "45001"
},
{
"Value": "ASIAN AMERICAN",
"Count": "5000+",
"ActualCount": "35,165",
"ActualValue": "35165"
},
{
"Value": "ASIAN PACIFIC AMERICAN",
"Count": "5000+",
"ActualCount": "19,956",
"ActualValue": "19956"
},
{
"Value": "ASIAN SUBCONTINENT AMERICAN",
"Count": "5000+",
"ActualCount": "11,045",
"ActualValue": "11045"
},
{
"Value": "NATIVE AMERICAN",
"Count": "5000+",
"ActualCount": "10,802",
"ActualValue": "10802"
},
{
"Value": "UNKNOWN",
"Count": "1,671",
"ActualCount": "1,671",
"ActualValue": "1671"
},
{
"Value": "MULTI RACIAL",
"Count": "167",
"ActualCount": "167",
"ActualValue": "167"
},
{
"Value": "ABORIGINAL",
"Count": "79",
"ActualCount": "79",
"ActualValue": "79"
}
]
}
}
}Try it
Query
API result
GetMatch
This method returns a list of potential matches. All matches are considered High or Medium quality matches (see definitions). Each search may return multiple match results.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| supplierName | Yes |
Supplier name or doing business as name. Examples:
|
|
| address | Yes |
Supplier's address. Where possible, provide physical addresses instead of P.O. Box addresses. Examples:
|
|
| city | Yes |
City associated with the address. Examples:
|
|
| state | Yes |
State associated with the address. Provide the two letter State code if country is USA/CAN. Examples:
|
|
| country | No |
Country associated with the address(ISO 3166-1 alpha-3 country code). Examples:
|
USA/CAN |
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
Results Example
{
"results": {
"Error": null,
"Suppliers": [
{
"Name": "A BEE R.A.G. SERVICE INC",
"Address": "415 MCCLELLAN AVE STE 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC.",
"Address": "415 MCCLELLAN AVE STE 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC",
"Address": "415 MCCLELLAN AVENUE STE. 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC.",
"Address": "415 MCCLELLAN AVENUE STE. 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC",
"Address": "415 McClellan Avenue Suite 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC.",
"Address": "415 McClellan Avenue Suite 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
}
]
}
}
Try it
Query
API result
GetMatchWithQuality
This method returns a list of potential matches with match quality equal or greater than the specified quality. Each search may return multiple match results.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| supplierName | Yes |
Supplier name or doing business as name. Examples:
|
|
| address | Yes |
Supplier's address. Where possible, provide physical addresses instead of P.O. Box addresses. Currently, the API only supports US addresses. Examples:
|
|
| city | Yes |
City associated with the address. Examples:
|
|
| state | Yes |
State associated with the address. Provide the two letter State code if country is USA/CAN. Examples:
|
|
| country | No |
Country associated with the address(ISO 3166-1 alpha-3 country code). Examples:
|
USA/CAN |
| minimumQuality | Yes |
The minimum match quality to include. Valid values for this field are:
|
|
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
| ConfidenceScore | No | Defines the minimum required confidence score for a match. The value should be a decimal between 0 and 1 (e.g., 0.9). Only matches with a confidence score equal to or exceeding this threshold will be returned. |
Results Example
{
"results": {
"Error": null,
"Suppliers": [
{
"Name": "A BEE R.A.G. SERVICE INC",
"Address": "415 MCCLELLAN AVE STE 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"QualityLevel": "High",
"ConfidenceScore": 0.98,
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC.",
"Address": "415 MCCLELLAN AVE STE 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"QualityLevel": "High",
"ConfidenceScore": 0.98,
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC",
"Address": "415 MCCLELLAN AVENUE STE. 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"QualityLevel": "High",
"ConfidenceScore": 0.98,
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC.",
"Address": "415 MCCLELLAN AVENUE STE. 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"QualityLevel": "High",
"ConfidenceScore": 0.98,
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC",
"Address": "415 McClellan Avenue Suite 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"QualityLevel": "High",
"ConfidenceScore": 0.98,
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
},
{
"Name": "A BEE R.A.G. SERVICE INC.",
"Address": "415 McClellan Avenue Suite 2",
"City": "MOUNT VERNON",
"State": "NY",
"SupplierId": "100572910",
"QualityLevel": "High",
"ConfidenceScore": 0.98,
"Diversity": [
"MINORITY-OWNED",
"WOMEN-OWNED",
"SMALL BUSINESS"
],
"Sustainability": [
"LOCAL BUSINESS ENTERPRISE"
],
"TrustIQ": null
}
]
}
}
Try it
Query
API result
GetBestMatch
This method returns the details of the best matched supplier. Use this call if you do not want to evaluate potential matches and will accept the match provided as it. In case where there are multiple matches of the same quality, any one of the matches will be randomly returned and the results may not be consistent with future calls with the same input.
Only High quality results are returned.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| supplierName | Yes |
Supplier name or doing business as name. Examples:
|
|
| address | Yes |
Supplier's address. Where possible, provide physical addresses instead of P.O. Box addresses. Currently, the API only supports US addresses. Examples:
|
|
| city | Yes |
City associated with the address. Examples:
|
|
| state | Yes |
State associated with the address. Provide the two letter State code if country is USA/CAN. Examples:
|
|
| country | No |
Country associated with the address(ISO 3166-1 alpha-3 country code). Examples:
|
USA/CAN |
| ein | No | This parameter represents the Employer Identification Number (EIN) associated with a particular entity. The EIN format typically consists of nine digits in the pattern XXXXXXXXX. Example: 123456789. | |
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
Results Example
{
"results": {
"Error": null,
"Phone": "7187984259",
"Website": "www.abrags.org",
"Established": "2006",
"Employee": "1-10",
"Revenue": "less than $500K",
"ActualRevenue": null,
"Actualemployees": null,
"Ethnicity": "AFRICAN AMERICAN",
"Ownership": [
"MBE",
"WBE"
],
"SmallBusinessClassifications": [
"SBE"
],
"NAICS": [
"561720",
"238310",
"238320",
"238330"
],
"NAICSDescription": [
"JANITORIAL SERVICES",
"DRYWALL AND INSULATION CONTRACTORS",
"PAINTING AND WALL COVERING CONTRACTORS",
"FLOORING CONTRACTORS"
],
"SIC": [],
"AlternateSupplierNames": [
"A BEE CONGLOMERATE"
],
"CertificationDetail": [
{
"Classification": "MBE",
"Agency": "The Port Authority of New York & New Jersey",
"ExpirationDate": "06-08-2024 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "MBE",
"Agency": "New York City School Construction Authority (NYCSA)",
"ExpirationDate": "16-01-2022 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "WBE",
"Agency": "The Port Authority of New York & New Jersey",
"ExpirationDate": "06-08-2024 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "WBE",
"Agency": "New York City School Construction Authority (NYCSA)",
"ExpirationDate": "16-01-2022 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "SBE",
"Agency": "City of New York, NY",
"ExpirationDate": "",
"CertificateNumber": ""
}
],
"SustainabilityCertificationDetail": [
{
"Classification": "LOCAL",
"Agency": "City of New York, NY",
"ExpirationDate": "",
"CertificateNumber": ""
}
],
"ContactDetail": [
{
"Name": "ERICA MITCHELL",
"Email": "sales@abrags.org",
"Title": ""
}
],
"SupplierID": "100572910",
"SupplierName": "A BEE R.A.G. SERVICE INC",
"Description": "Carpet Cleaning; Floor Waxing; Painting; Residential Cleaning; Church Cleaning; Interior Painting",
"Address": "415 McClellan Avenue Suite 2",
"City": "MOUNT VERNON",
"State": "NY",
"Zip": "10553",
"Country": "USA",
"TrustIQ": null
}
}
Try it
Query
API result
GetBestMatchV2
This method returns the details of the most suitable matched supplier using enhanced matching logic. This endpoint is ideal when you prefer to rely on an automated selection without manually evaluating potential matches. If multiple suppliers have the same match quality, one will be returned at random. As a result, repeated calls with the same input may yield different results.
Only high-quality results are returned.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| supplierName | Yes |
Supplier name or doing business as name. Examples:
|
|
| address | Yes |
Supplier's address. Where possible, provide physical addresses instead of P.O. Box addresses. Currently, the API only supports US addresses. Examples:
|
|
| city | Yes |
City associated with the address. Examples:
|
|
| state | Yes |
State associated with the address. Provide the two letter State code if country is USA/CAN. Examples:
|
|
| country | No |
Country associated with the address(ISO 3166-1 alpha-3 country code). Examples:
|
USA/CAN |
| ein | No | This parameter represents the Employer Identification Number (EIN) associated with a particular entity. The EIN format typically consists of nine digits in the pattern XXXXXXXXX. Example: 123456789. | |
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
Results Example
{
"results": {
"Error": null,
"Phone": "7187984259",
"Website": "www.abrags.org",
"Established": "2006",
"Employee": "1-10",
"Revenue": "less than $500K",
"ActualRevenue": null,
"Actualemployees": null,
"Ethnicity": "AFRICAN AMERICAN",
"Ownership": [
"MBE",
"WBE"
],
"SmallBusinessClassifications": [
"SBE"
],
"NAICS": [
"561720",
"238310",
"238320",
"238330"
],
"NAICSDescription": [
"JANITORIAL SERVICES",
"DRYWALL AND INSULATION CONTRACTORS",
"PAINTING AND WALL COVERING CONTRACTORS",
"FLOORING CONTRACTORS"
],
"SIC": [],
"AlternateSupplierNames": [
"A BEE CONGLOMERATE"
],
"CertificationDetail": [
{
"Classification": "MBE",
"Agency": "The Port Authority of New York & New Jersey",
"ExpirationDate": "06-08-2024 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "MBE",
"Agency": "New York City School Construction Authority (NYCSA)",
"ExpirationDate": "16-01-2022 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "WBE",
"Agency": "The Port Authority of New York & New Jersey",
"ExpirationDate": "06-08-2024 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "WBE",
"Agency": "New York City School Construction Authority (NYCSA)",
"ExpirationDate": "16-01-2022 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "SBE",
"Agency": "City of New York, NY",
"ExpirationDate": "",
"CertificateNumber": ""
}
],
"SustainabilityCertificationDetail": [
{
"Classification": "LOCAL",
"Agency": "City of New York, NY",
"ExpirationDate": "",
"CertificateNumber": ""
}
],
"ContactDetail": [
{
"Name": "ERICA MITCHELL",
"Email": "sales@abrags.org",
"Title": ""
}
],
"SupplierID": "100572910",
"SupplierName": "A BEE R.A.G. SERVICE INC",
"Description": "Carpet Cleaning; Floor Waxing; Painting; Residential Cleaning; Church Cleaning; Interior Painting",
"Address": "415 McClellan Avenue Suite 2",
"City": "MOUNT VERNON",
"State": "NY",
"Zip": "10553",
"Country": "USA"
}
}
Try it
Query
API result
SubmitMatch
This function accepts XXX records for bulk processing. It returns a job ID. Once the job is ready it also calls the callback function (if configured) and passes the job ID and number of matches with status. User can use GetMatchResult for getting the results back.
5000 is the maximum number of records that can be submitted.
Only quality results are retrieved.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| Supplier List | Yes |
List of supplier contains following fields:-
inputSupplierId Matched supplier will be returned with the inputSupplierId. inputSupplierName Supplier name or doing business as name. Examples:
inputAddress Supplier's address. Where possible, provide physical addresses instead of P.O. Box addresses. Currently, the API only supports US addresses. Examples:
inputCity City associated with the address. Examples:
inputState State associated with the address. Provide the two letter State code if country is USA/CAN. Examples:
inputCountry Country associated with the address. Provide the 3 letter Country code (ISO 3166-1 alpha-3 country code). USA/CAN is the default value. Examples:
inputEin This parameter represents the Employer Identification Number (EIN) associated with a particular entity. The EIN format typically consists of nine digits in the pattern XXXXXXXXX. Example: 123456789. |
|
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
Request Example
In Params
KEY : VALUE
------------------------------------------------------------
APIKey : b18f18f036104787af0142f7c0fc4e39
customerId : 98375
customerName : Demo
In Body Row JSON
{
"suppliers" :[{
"inputSupplierId":"1",
"inputSupplierName": "KDL HARDWARE SUPPLY INC",
"inputAddress": "850 POPLAR PL SOUTH POB 24746",
"inputCity": "seattle",
"inputState": "wa",
"inputCountry": "USA",
"inputEin":""
},
{
"inputSupplierId":"2",
"inputSupplierName": "RF DESIGN AND INTEGRATION INC",
"inputAddress": "792 HAUNTED LANE",
"inputCity": "bensalem",
"inputState": "pa",
"inputCountry": "USA",
"inputEin":""
}
]
}
Results Example
{
"StatusCode": 200,
"Message": null,
"Data": {
"JobId": "d653e45de3e040bcad277c4ffe7647f8",
"NumberOfInputRecord": 2,
"Status": "Received"
},
"Errors": null
}
SubmitMatchV2
This function accepts XXX records for improved bulk matching using enhanced logic. It returns a job ID for tracking the submission. Once processing is complete, the system will invoke the configured callback function (if provided), returning the job ID, match count, and status. Users can retrieve the results using the GetMatchResult endpoint.
The maximum number of records that can be submitted in a single request is 5,000.
Only quality results are retrieved.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| Supplier List | Yes |
List of supplier contains following fields:-
inputSupplierId Matched supplier will be returned with the inputSupplierId. inputSupplierName Supplier name or doing business as name. Examples:
inputAddress Supplier's address. Where possible, provide physical addresses instead of P.O. Box addresses. Currently, the API only supports US addresses. Examples:
inputCity City associated with the address. Examples:
inputState State associated with the address. Provide the two letter State code if country is USA/CAN. Examples:
inputCountry Country associated with the address. Provide the 3 letter Country code (ISO 3166-1 alpha-3 country code). USA/CAN is the default value. Examples:
inputEin This parameter represents the Employer Identification Number (EIN) associated with a particular entity. The EIN format typically consists of nine digits in the pattern XXXXXXXXX. Example: 123456789. |
|
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
Request Example
In Params
KEY : VALUE
------------------------------------------------------------
APIKey : b18f18f036104787af0142f7c0fc4e39
customerId : 98375
customerName : Demo
In Body Row JSON
{
"suppliers" :[{
"inputSupplierId":"1",
"inputSupplierName": "KDL HARDWARE SUPPLY INC",
"inputAddress": "850 POPLAR PL SOUTH POB 24746",
"inputCity": "seattle",
"inputState": "wa",
"inputCountry": "USA",
"inputEin":""
},
{
"inputSupplierId":"2",
"inputSupplierName": "RF DESIGN AND INTEGRATION INC",
"inputAddress": "792 HAUNTED LANE",
"inputCity": "bensalem",
"inputState": "pa",
"inputCountry": "USA",
"inputEin":""
}
]
}
Results Example
{
"StatusCode": 200,
"Message": null,
"Data": {
"JobId": "d653e45de3e040bcad277c4ffe7647f8",
"NumberOfInputRecord": 2,
"Status": "Received"
},
"Errors": null
}
GetMatchResults
This function returns a status of Job created in SubmitMatch and SubmitMatchV2 request. It returns a status of job like "Processing", "Error" and no results. If Job is completed it return match results.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| jobId | Yes | Returned by SubmitMatch, SubmitMatchV2, or GetSuppliers. |
Results Example
{
"StatusCode": 200,
"Message": null,
"Data": {
"JobId": "faeb532198f742fcafc418d9bbb0d50d",
"NumberOfInputRecord": 1,
"Status": "Completed",
"Suppliers": [
{
"InputSupplierId": "1",
"MatchedSuppliers": [
{
"Error": null,
"Phone": "7187984259",
"Website": "www.abrags.org",
"Established": "2006",
"Employee": "1-10",
"Revenue": "less than $500K",
"ActualRevenue": null,
"Actualemployees": null,
"Ethnicity": "AFRICAN AMERICAN",
"Ownership": [
"MBE",
"WBE"
],
"SmallBusinessClassifications": [
"SBE"
],
"NAICS": [
"561720",
"238310",
"238320",
"238330"
],
"NAICSDescription": [
"JANITORIAL SERVICES",
"DRYWALL AND INSULATION CONTRACTORS",
"PAINTING AND WALL COVERING CONTRACTORS",
"FLOORING CONTRACTORS"
],
"SIC": [],
"AlternateSupplierNames": [
"A BEE CONGLOMERATE"
],
"CertificationDetail": [
{
"Classification": "MBE",
"Agency": "The Port Authority of New York & New Jersey",
"ExpirationDate": "06-08-2024 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "MBE",
"Agency": "New York City School Construction Authority (NYCSA)",
"ExpirationDate": "16-01-2022 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "WBE",
"Agency": "The Port Authority of New York & New Jersey",
"ExpirationDate": "06-08-2024 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "WBE",
"Agency": "New York City School Construction Authority (NYCSA)",
"ExpirationDate": "16-01-2022 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "SBE",
"Agency": "City of New York, NY",
"ExpirationDate": "",
"CertificateNumber": ""
}
],
"SustainabilityCertificationDetail": [
{
"Classification": "LOCAL",
"Agency": "City of New York, NY",
"ExpirationDate": "",
"CertificateNumber": ""
}
],
"ContactDetail": [
{
"Name": "ERICA MITCHELL",
"Email": "sales@abrags.org",
"Title": ""
}
],
"SupplierID": "100572910",
"SupplierName": "A BEE R.A.G. SERVICE INC",
"Description": "Carpet Cleaning; Floor Waxing; Painting; Residential Cleaning; Church Cleaning; Interior Painting",
"Address": "415 McClellan Avenue Suite 2",
"City": "MOUNT VERNON",
"State": "NY",
"Zip": "10553",
"Country": "USA",
"TrustIQ": null
}
]
}
]
},
"Errors": null
}
Suppliers
GetSupplierDetail
The method returns the supplier information identified by the supplier.io Supplier ID. Results are returned in JSON format.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| supplierID | Yes | supplier.io Suppiler ID for the supplier to be retrieved. | |
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
Results Example
{
"results": {
"Error": null,
"Phone": "7187984259",
"Website": "www.abrags.org",
"Established": "2006",
"Employee": "1-10",
"Revenue": "less than $500K",
"ActualRevenue": null,
"Actualemployees": null,
"Ethnicity": "AFRICAN AMERICAN",
"Ownership": [
"MBE",
"WBE"
],
"SmallBusinessClassifications": [
"SBE"
],
"NAICS": [
"561720",
"238310",
"238320",
"238330"
],
"NAICSDescription": [
"JANITORIAL SERVICES",
"DRYWALL AND INSULATION CONTRACTORS",
"PAINTING AND WALL COVERING CONTRACTORS",
"FLOORING CONTRACTORS"
],
"SIC": [],
"AlternateSupplierNames": [
"A BEE CONGLOMERATE"
],
"CertificationDetail": [
{
"Classification": "MBE",
"Agency": "The Port Authority of New York & New Jersey",
"ExpirationDate": "06-08-2024 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "MBE",
"Agency": "New York City School Construction Authority (NYCSA)",
"ExpirationDate": "16-01-2022 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "WBE",
"Agency": "The Port Authority of New York & New Jersey",
"ExpirationDate": "06-08-2024 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "WBE",
"Agency": "New York City School Construction Authority (NYCSA)",
"ExpirationDate": "16-01-2022 00:00:00",
"CertificateNumber": ""
},
{
"Classification": "SBE",
"Agency": "City of New York, NY",
"ExpirationDate": "",
"CertificateNumber": ""
}
],
"SustainabilityCertificationDetail": [
{
"Classification": "LOCAL",
"Agency": "City of New York, NY",
"ExpirationDate": "",
"CertificateNumber": ""
}
],
"ContactDetail": [
{
"Name": "ERICA MITCHELL",
"Email": "sales@abrags.org",
"Title": ""
}
],
"SupplierID": "100572910",
"SupplierName": "A BEE R.A.G. SERVICE INC",
"Description": "Carpet Cleaning; Floor Waxing; Painting; Residential Cleaning; Church Cleaning; Interior Painting",
"Address": "415 McClellan Avenue Suite 2",
"City": "MOUNT VERNON",
"State": "NY",
"Zip": "10553",
"Country": "USA",
"TrustIQ": null
}
}
Try it
Query
API result
GetSuppliers
This function accepts X SIO IDs or RecallKeys for bulk processing, It returns a job ID. Once the job is ready it also calls the callback function (if configured) and passes the job ID and return status. User can use GetMatchResults using JobID for getting actual results back.
5000 is the maximum number of records that can be submitted.
Input
| Field | Required | Description | Default Value |
|---|---|---|---|
| APIKEY | Yes | Used for API authentication. | |
| customerID | Yes |
Assigned Customer ID. Used to validate customer's access to the API.
|
|
| customerName | Yes | Assigned Customer Name | |
| supplierIds | Yes | List of Supplier Id or RecallKey | |
| EnableDiverse | No | A flag indicating whether suppliers should be returned based on diversity or small business criteria. If set to "True", only suppliers that meet diversity or small business requirements will be returned. If set to "False", no diverse or small business suppliers will be included. Default is "True". | True |
| EnableSustainable | No | A flag indicating whether suppliers should be returned based on environmental or social certifications. If set to "True", only suppliers with sustainability certifications will be returned. If set to "False", suppliers without sustainability criteria will not be included. Default is "False". | False |
Request Example
In Params
KEY : VALUE
------------------------------------------------------------
APIKey : b18f18f036104787af0142f7c0fc4e39
customerId : 98375
customerName : Demo
In Body Row JSON
{
"supplierIds" :[
"yYQrlycoPave",
"Am71PPfO8gYj"
]
}
Results Example
{
"StatusCode": 200,
"Message": null,
"Data": {
"JobId": "d653e45de3e040bcad277c4ffe7647f8",
"NumberOfInputRecord": 3,
"Status": "Received"
},
"Errors": null
}