Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
A universal identifier string unique to a particular business.
"ac4d4ebc-8bb9-4927-8fd5-6ea677afeed2"
Response
OK
Indicates whether the request succeeded or failed.
success
, fail
Descriptive message about the result of the operation.
"Business KYB details fetched successfully"
{
"address_match": {
"name": "address_match",
"value": "success",
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["primary_address", "addresses"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"address_match_boolean": {
"name": "address_match_boolean",
"value": true,
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["address_match"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"address_registered_agent": {
"name": "address_registered_agent",
"value": null,
"schema": null,
"source": null,
"override": null,
"alternatives": []
},
"address_verification": {
"name": "address_verification",
"value": {
"addresses": [
"10 Laurel Ave, Suite 300, Wellesley, MA, 02481",
"354 Circle Ct, Bronx, NY, 10468"
],
"status": "success",
"message": "Match identified to the submitted Office Address",
"label": "Office Address",
"sublabel": "Verified"
},
"schema": null,
"source": { "confidence": 0.95, "platformId": 16 },
"override": null,
"source.confidence": 0.95,
"source.platformId": 16,
"alternatives": []
},
"address_verification_boolean": {
"name": "address_verification_boolean",
"value": true,
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["address_verification"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"addresses": {
"name": "addresses",
"value": [
"10 Laurel Ave, Suite 300, Wellesley, MA, 02481",
"354 Circle Ct, Bronx, NY, 10468"
],
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "array",
"items": { "type": "string" }
},
"source": { "confidence": null, "platformId": null },
"override": null,
"source.confidence": null,
"source.platformId": null,
"alternatives": [
{
"value": [
"10 LAUREL AVE STE 300, WELLESLEY HILLS, MA 2481"
],
"source": 17,
"updatedAt": "2025-09-29T23:51:18.445Z"
},
{
"value": [
"Suite #300 10 Laurel Avenue , Wellesley, MA 02481",
"354 Circle Court,Bronx, NY 10468"
],
"source": 16,
"confidence": 0.95
},
{
"value": [
"10 Laurel Ave, Wellesley Hills, Massachusetts 02481"
],
"source": 24,
"confidence": 1,
"updatedAt": "2025-09-29T23:48:44.198Z"
}
],
"isNormalized": true
},
"addresses_deliverable": {
"name": "addresses_deliverable",
"value": ["354 Circle Ct, Bronx, NY, 10468"],
"schema": null,
"source": { "confidence": 0.95, "platformId": 16 },
"override": null,
"source.confidence": 0.95,
"source.platformId": 16,
"alternatives": []
},
"addresses_found": {
"name": "addresses_found",
"value": [
"10 Laurel Ave, Ste 300, Wellesley Hills, MA",
"354 Circle Ct, Bronx, NY, 10468, United States"
],
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "array",
"items": { "type": "string" }
},
"source": { "confidence": null, "platformId": null },
"override": null,
"source.confidence": null,
"source.platformId": null,
"alternatives": [
{
"value": ["354 Circle Court,Bronx, NY 10468"],
"source": 16,
"confidence": 0.95
},
{
"value": [
"10 Laurel Ave, Wellesley Hills, Massachusetts 02481"
],
"source": 24,
"confidence": 1,
"updatedAt": "2025-09-29T23:48:44.198Z"
}
],
"isNormalized": true
},
"addresses_submitted": {
"name": "addresses_submitted",
"value": [
"Suite #300 10 Laurel Avenue , Wellesley, MA 02481"
],
"schema": null,
"source": { "confidence": 0.95, "platformId": 16 },
"override": null,
"source.confidence": 0.95,
"source.platformId": 16,
"alternatives": []
},
"corporation": {
"name": "corporation",
"value": "Private",
"schema": null,
"source": {
"confidence": 1,
"platformId": 24,
"updatedAt": "2025-09-29T23:48:44.198Z"
},
"override": null,
"source.confidence": 1,
"source.platformId": 24,
"alternatives": []
},
"countries": {
"name": "countries",
"value": ["US"],
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["addresses"],
"description": "Countries (in ISO 3166-1 alpha-2 format) that the business has an address in",
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"dba_found": {
"name": "dba_found",
"value": [
"Example Business PC",
"Example Business LLC",
"Example Business",
"EXAMPLE BUSINESS, LLC"
],
"schema": null,
"source": { "confidence": null, "platformId": null },
"override": null,
"source.confidence": null,
"source.platformId": null,
"alternatives": [
{
"value": [
"Example Business PC",
"Example Business LLC",
"Example Business",
"EXAMPLE BUSINESS, LLC"
],
"source": 24,
"confidence": 1,
"updatedAt": "2025-09-29T23:48:44.198Z"
}
]
},
"email": {
"name": "email",
"value": "john.doe@examplebusiness.com",
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
{ "type": "null" }
]
},
"source": {
"confidence": null,
"platformId": 17,
"updatedAt": "2025-09-29T23:51:18.445Z"
},
"override": null,
"source.confidence": null,
"source.platformId": 17,
"alternatives": []
},
"formation_date": {
"name": "formation_date",
"value": "2012-08-23",
"schema": null,
"source": {
"confidence": 1,
"platformId": 23,
"updatedAt": "2025-09-29T23:47:56.576Z"
},
"override": null,
"source.confidence": 1,
"source.platformId": 23,
"alternatives": [
{
"value": "2007-01-01",
"source": 24,
"confidence": 0.2,
"updatedAt": "2025-09-29T23:48:44.198Z"
}
]
},
"formation_state": {
"name": "formation_state",
"value": "MA",
"schema": null,
"source": { "confidence": 0.95, "platformId": 16 },
"override": null,
"source.confidence": 0.95,
"source.platformId": 16,
"alternatives": []
},
"idv_passed": {
"name": "idv_passed",
"value": null,
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "number"
},
"source": null,
"override": null,
"alternatives": [],
"dependencies": ["idv_status"]
},
"idv_passed_boolean": {
"name": "idv_passed_boolean",
"value": null,
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "boolean"
},
"source": null,
"override": null,
"alternatives": [],
"dependencies": ["idv_passed"]
},
"idv_status": {
"name": "idv_status",
"value": null,
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"propertyNames": {
"type": "string",
"enum": [
"SUCCESS",
"PENDING",
"CANCELED",
"EXPIRED",
"FAILED"
]
},
"additionalProperties": { "type": "number" }
},
"source": null,
"override": null,
"alternatives": []
},
"is_sole_prop": {
"name": "is_sole_prop",
"value": null,
"schema": null,
"source": null,
"override": null,
"alternatives": [],
"dependencies": ["tin_submitted", "idv_passed_boolean"]
},
"kyb_submitted": {
"name": "kyb_submitted",
"value": true,
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["addresses"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"legal_name": {
"name": "legal_name",
"value": "EXAMPLE BUSINESS, LLC",
"schema": null,
"source": {
"confidence": 1,
"platformId": 23,
"updatedAt": "2025-09-29T23:47:56.576Z"
},
"override": null,
"source.confidence": 1,
"source.platformId": 23,
"alternatives": [
{
"value": "Example Business",
"source": 16,
"confidence": 0.95
},
{
"value": "Example Business",
"source": 0,
"confidence": 1,
"updatedAt": "2025-09-29T23:46:04.906Z"
}
]
},
"minority_owned": {
"name": "minority_owned",
"value": null,
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [{ "type": "boolean" }, { "type": "null" }]
},
"source": null,
"override": null,
"alternatives": []
},
"name_match": {
"name": "name_match",
"value": {
"status": "success",
"message": "Match Found",
"sublabel": ""
},
"schema": null,
"source": {
"confidence": 1,
"platformId": 23,
"updatedAt": "2025-09-29T23:47:56.576Z"
},
"override": null,
"source.confidence": 1,
"source.platformId": 23,
"alternatives": [
{
"value": {
"status": "success",
"message": "Match identified to the submitted Business Name",
"sublabel": "Verified"
},
"source": 16,
"confidence": 0.95
}
]
},
"name_match_boolean": {
"name": "name_match_boolean",
"value": true,
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["name_match"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"names_found": {
"name": "names_found",
"value": [
"Example Business PC",
"Example Business LLC",
"Example Business",
"EXAMPLE BUSINESS, LLC"
],
"schema": null,
"source": { "confidence": null, "platformId": null },
"override": null,
"source.confidence": null,
"source.platformId": null,
"alternatives": [
{
"value": ["Example Business", "EXAMPLE BUSINESS, LLC"],
"source": 0,
"confidence": 1,
"updatedAt": "2025-09-29T23:48:44.198Z"
}
]
},
"names_submitted": {
"name": "names_submitted",
"value": [
{
"name": "Example Business",
"submitted": true
}
],
"schema": null,
"source": { "confidence": 0.95, "platformId": 16 },
"override": null,
"source.confidence": 0.95,
"source.platformId": 16,
"alternatives": []
},
"people": {
"name": "people",
"value": [
{
"name": "JOHN DOE",
"titles": ["Owner"],
"jurisdictions": ["us::"]
},
{
"name": "JANE SMITH",
"titles": ["President"],
"jurisdictions": ["us::tx"]
}
],
"schema": null,
"source": {
"confidence": null,
"platformId": 17,
"updatedAt": "2025-09-29T23:51:18.445Z"
},
"override": null,
"source.confidence": null,
"source.platformId": 17,
"alternatives": []
},
"phone_found": {
"name": "phone_found",
"value": ["12223334444", "(222) 333-4444"],
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "array",
"items": { "type": "string" }
},
"source": { "confidence": null, "platformId": null },
"override": null,
"source.confidence": null,
"source.platformId": null,
"alternatives": [
{
"value": "+1 2223334444",
"source": 24,
"confidence": 1,
"updatedAt": "2025-09-29T23:48:44.198Z"
},
{
"value": 2223334444,
"source": 17,
"updatedAt": "2025-09-29T23:51:18.445Z"
}
],
"isNormalized": true
},
"primary_address": {
"name": "primary_address",
"value": {
"line_1": "123 Maple Avenue",
"apartment": null,
"city": "Springfield",
"state": "IL",
"country": "US",
"postal_code": "62704",
"mobile": null,
"is_primary": true
},
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["addresses"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"sos_active": {
"name": "sos_active",
"value": true,
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["sos_filings"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"sos_filings": {
"name": "sos_filings",
"value": [
{
"id": "us_ma-1234567",
"filing_date": "2012-01-23",
"registration_date": "2012-01-23",
"entity_type": "llc",
"filing_name": "EXAMPLE BUSINESS, LLC",
"active": true,
"foreign_domestic": "domestic",
"state": "MA",
"url": "https://corp.sec.state.ma.us/CorpWeb/CorpSearch/CorpSearch.aspx",
"jurisdiction": "us::ma",
"officers": []
}
],
"schema": null,
"source": {
"confidence": 1,
"platformId": 23,
"updatedAt": "2025-09-29T23:47:56.576Z"
},
"override": null,
"source.confidence": 1,
"source.platformId": 23,
"alternatives": [
{
"value": [
{
"jurisdiction": "us::ma",
"id": "1fed3e62-bd0b-46c7-9e01-4e12202b543b",
"internal_reference": "cd0e17cf-99a9-4d60-9696-5c9ca53eb5ee",
"filing_date": "2020-02-24T00:00:00.000Z",
"entity_type": "CORPORATION",
"active": true,
"state": "MA",
"url": "http://corp.sec.state.ma.us/CorpWeb/CorpSearch/CorpSearch.aspx",
"filing_name": "Example Business",
"registration_date": "2020-02-24T00:00:00.000Z",
"officers": []
}
],
"source": 16,
"confidence": 0.95
}
]
},
"sos_match": {
"name": "sos_match",
"value": "success",
"schema": null,
"source": {
"confidence": 1,
"platformId": 23,
"updatedAt": "2025-09-29T23:47:56.576Z"
},
"override": null,
"source.confidence": 1,
"source.platformId": 23,
"alternatives": [
{
"value": "success",
"source": 16,
"confidence": 0.95
}
]
},
"sos_match_boolean": {
"name": "sos_match_boolean",
"value": true,
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["sos_match"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"stock_symbol": {
"name": "stock_symbol",
"value": null,
"schema": null,
"source": null,
"override": null,
"alternatives": []
},
"tin": {
"name": "tin",
"value": "343434343",
"schema": null,
"source": {
"confidence": 1,
"platformId": 0,
"updatedAt": "2025-09-29T23:46:04.906Z"
},
"override": null,
"source.confidence": 1,
"source.platformId": 0,
"alternatives": [
{
"value": "343434343",
"source": 16,
"confidence": 0.95
}
]
},
"tin_match": {
"name": "tin_match",
"value": {
"status": "success",
"message": "The IRS has a record for the submitted TIN and Business Name combination",
"sublabel": "Found"
},
"schema": null,
"source": { "confidence": 0.95, "platformId": 16 },
"override": null,
"source.confidence": 0.95,
"source.platformId": 16,
"alternatives": []
},
"tin_match_boolean": {
"name": "tin_match_boolean",
"value": true,
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["tin_match"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"tin_submitted": {
"name": "tin_submitted",
"value": "XXXXX4343",
"schema": null,
"source": {
"confidence": 1,
"platformId": 0,
"updatedAt": "2025-09-29T23:46:04.906Z"
},
"override": null,
"description": "The TIN provided for the business",
"source.confidence": 1,
"source.platformId": 0,
"alternatives": [
{
"value": "XXXXX4343",
"source": 16,
"confidence": 0.95
},
{
"value": "XXXXX4343",
"source": 16,
"updatedAt": "2025-09-29T23:46:04.318Z"
}
]
},
"veteran_owned": {
"name": "veteran_owned",
"value": null,
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [{ "type": "boolean" }, { "type": "null" }]
},
"source": null,
"override": null,
"alternatives": []
},
"watchlist": {
"name": "watchlist",
"value": {
"metadata": [],
"message": "No Watchlist hits were identified"
},
"schema": null,
"source": { "confidence": 0.95, "platformId": 16 },
"override": null,
"source.confidence": 0.95,
"source.platformId": 16,
"alternatives": []
},
"watchlist_hits": {
"name": "watchlist_hits",
"value": 0,
"schema": null,
"source": { "confidence": null, "platformId": -1 },
"override": null,
"dependencies": ["watchlist"],
"source.confidence": null,
"source.platformId": -1,
"alternatives": []
},
"website_found": {
"name": "website_found",
"value": [
"http://examplebusiness.com",
"http://www.examplebusiness.com",
"https://examplebusiness.com"
],
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "array",
"items": { "type": "string", "format": "uri" }
},
"source": { "confidence": null, "platformId": null },
"override": null,
"source.confidence": null,
"source.platformId": null,
"alternatives": [
{
"value": "examplebusiness.com",
"source": 24,
"confidence": 1,
"updatedAt": "2025-09-29T23:48:44.198Z"
},
{
"value": "www.examplebusiness.com",
"source": 17,
"updatedAt": "2025-09-29T23:51:18.445Z"
},
{
"value": "https://examplebusiness.com",
"source": 36,
"confidence": 0.2,
"updatedAt": "2025-09-29T23:46:06.270Z"
}
],
"isNormalized": true
},
"woman_owned": {
"name": "woman_owned",
"value": null,
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [{ "type": "boolean" }, { "type": "null" }]
},
"source": null,
"override": null,
"alternatives": []
},
"year_established": {
"name": "year_established",
"value": "2012",
"schema": null,
"source": {
"confidence": 1,
"platformId": 23,
"updatedAt": "2025-09-29T23:47:56.576Z"
},
"override": null,
"source.confidence": 1,
"source.platformId": 23,
"alternatives": [
{
"value": "2020",
"source": 16,
"confidence": 0.95
},
{
"value": "2007",
"source": 24,
"confidence": 1,
"updatedAt": "2025-09-29T23:48:44.198Z"
},
{
"value": "2010",
"source": 17,
"updatedAt": "2025-09-29T23:51:18.445Z"
}
]
},
"process_completion_data": {
"all_kyb_processes_complete": true,
"last_updated": "2025-09-29T23:58:54Z"
}
}