GET
/
facts
/
business
/
{businessId}
/
kyb
curl --request GET \
  --url https://api.joinworth.com/integration/api/v1/facts/business/{businessId}/kyb \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "message": "Business KYB details fetched successfully",
  "data": {
    "address_match": {
      "name": "address_match",
      "value": "failure",
      "dependencies": [
        "primary_address",
        "addresses"
      ],
      "alternatives": [
        {
          "value": "failure",
          "confidence": 0.9
        }
      ]
    },
    "address_match_boolean": {
      "name": "address_match_boolean",
      "value": false,
      "dependencies": [
        "address_match"
      ],
      "alternatives": [
        {
          "value": false
        }
      ]
    },
    "address_registered_agent": {
      "name": "address_registered_agent",
      "value": null,
      "alternatives": []
    },
    "address_verification": {
      "name": "address_verification",
      "value": {
        "addresses": [
          "5529 186th Pl SW, Lynnwood, WA 98037-4325",
          "581 Old Sunset Hill Rd, Hendersonville, NC 28792-8362",
          "954 E Union St, Seattle, WA 98122-4289",
          "300 E Lombard St, Baltimore, MD 21202-3219",
          "92 Hardwood Way, Brattleboro, VT 05301-2951"
        ],
        "status": "success",
        "message": "Match identified to the submitted Office Address",
        "label": "Office Address",
        "sublabel": "Verified"
      },
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": {
            "addresses": [
              "5529 186th Pl SW, Lynnwood, WA 98037-4325",
              "581 Old Sunset Hill Rd, Hendersonville, NC 28792-8362",
              "954 E Union St, Seattle, WA 98122-4289",
              "300 E Lombard St, Baltimore, MD 21202-3219",
              "92 Hardwood Way, Brattleboro, VT 05301-2951"
            ],
            "status": "success",
            "message": "Match identified to the submitted Office Address",
            "label": "Office Address",
            "sublabel": "Verified"
          },
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "address_verification_boolean": {
      "name": "address_verification_boolean",
      "value": true,
      "dependencies": [
        "address_verification"
      ],
      "alternatives": [
        {
          "value": true
        }
      ]
    },
    "addresses": {
      "name": "addresses",
      "value": [
        "5529 186th Pl SW, Lynnwood, WA 98037-4325",
        "581 Old Sunset Hill Rd, Hendersonville, NC 28792-8362",
        "954 E Union St, Seattle, WA 98122-4289",
        "300 E Lombard St, Baltimore, MD 21202-3219",
        "92 Hardwood Way, Brattleboro, VT 05301-2951"
      ],
      "alternatives": [
        {
          "value": [
            "5529 186th Pl SW, Lynnwood, WA 98037-4325",
            "581 Old Sunset Hill Rd, Hendersonville, NC 28792-8362",
            "954 E Union St, Seattle, WA 98122-4289",
            "300 E Lombard St, Baltimore, MD 21202-3219",
            "92 Hardwood Way, Brattleboro, VT 05301-2951"
          ],
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "addresses_deliverable": {
      "name": "addresses_deliverable",
      "value": [
        "5529 186th Pl SW, Lynnwood, WA 98037-4325",
        "581 Old Sunset Hill Rd, Hendersonville, NC 28792-8362",
        "954 E Union St, Seattle, WA 98122-4289",
        "300 E Lombard St, Baltimore, MD 21202-3219",
        "92 Hardwood Way, Brattleboro, VT 05301-2951"
      ],
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": [
            "5529 186th Pl SW, Lynnwood, WA 98037-4325",
            "581 Old Sunset Hill Rd, Hendersonville, NC 28792-8362",
            "954 E Union St, Seattle, WA 98122-4289",
            "300 E Lombard St, Baltimore, MD 21202-3219",
            "92 Hardwood Way, Brattleboro, VT 05301-2951"
          ],
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "corporation": {
      "name": "corporation",
      "value": null,
      "source.platformId": 17,
      "alternatives": [
        {
          "value": null,
          "source": 17
        }
      ]
    },
    "formation_date": {
      "name": "formation_date",
      "value": "1988-09-08T00:00:00.000Z",
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": "1988-09-08T00:00:00.000Z",
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "formation_state": {
      "name": "formation_state",
      "value": "WA",
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": "WA",
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "kyb_submitted": {
      "name": "kyb_submitted",
      "value": true,
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": true,
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "legal_name": {
      "name": "legal_name",
      "value": "WARM PRODUCTS INC",
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": "WARM PRODUCTS INC",
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "minority_owned": {
      "name": "minority_owned",
      "value": null,
      "alternatives": []
    },
    "name_match": {
      "name": "name_match",
      "value": {
        "status": "success",
        "message": "Match identified to the submitted Business Name",
        "sublabel": "Verified"
      },
      "source.confidence": 0.95,
      "source.platformId": 16,
      "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,
      "dependencies": [
        "name_match"
      ],
      "alternatives": [
        {
          "value": true
        }
      ]
    },
    "names_submitted": {
      "name": "names_submitted",
      "value": [
        {
          "name": "WARM PRODUCTS INC",
          "submitted": true
        }
      ],
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": [
            {
              "name": "WARM PRODUCTS INC",
              "submitted": true
            }
          ],
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "people": {
      "name": "people",
      "value": [
        {
          "name": "Chumbley, J Michael Ryan",
          "titles": [
            "CHIEF EXECUTIVE OFFICER",
            "GOVERNINGPERSON"
          ],
          "submitted": false,
          "source": [
            "20199147-bf82-4775-a9db-3ce48ba07ed1",
            "642c8178-fe65-43e2-9f39-cab7453f08e8"
          ]
        },
        {
          "name": "Johnson, Erica",
          "titles": [
            "SENIOR VICE PRESIDENT"
          ],
          "submitted": false,
          "source": [
            "20199147-bf82-4775-a9db-3ce48ba07ed1",
            "89b0caea-2023-43e0-b3d8-614e5f2d1935"
          ]
        },
        {
          "name": "EVELYN CHUMBLEY",
          "titles": [
            "GOVERNINGPERSON",
            "SECRETARY"
          ],
          "submitted": false,
          "source": [
            "642c8178-fe65-43e2-9f39-cab7453f08e8",
            "d8bae094-c6a1-40b2-83a5-b5c035d3d038"
          ]
        },
        {
          "name": "JAMES CHUMBLEY",
          "titles": [
            "GOVERNINGPERSON",
            "PRESIDENT"
          ],
          "submitted": false,
          "source": [
            "642c8178-fe65-43e2-9f39-cab7453f08e8",
            "d8bae094-c6a1-40b2-83a5-b5c035d3d038"
          ]
        },
        {
          "name": "BRYAN WITTLER                                                                                       ",
          "titles": [
            "REGISTERED AGENT"
          ],
          "submitted": false,
          "source": [
            "d8bae094-c6a1-40b2-83a5-b5c035d3d038"
          ]
        }
      ],
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": [
            {
              "name": "Chumbley, J Michael Ryan",
              "titles": [
                "CHIEF EXECUTIVE OFFICER",
                "GOVERNINGPERSON"
              ],
              "submitted": false,
              "source": [
                "20199147-bf82-4775-a9db-3ce48ba07ed1",
                "642c8178-fe65-43e2-9f39-cab7453f08e8"
              ]
            },
            {
              "name": "Johnson, Erica",
              "titles": [
                "SENIOR VICE PRESIDENT"
              ],
              "submitted": false,
              "source": [
                "20199147-bf82-4775-a9db-3ce48ba07ed1",
                "89b0caea-2023-43e0-b3d8-614e5f2d1935"
              ]
            },
            {
              "name": "EVELYN CHUMBLEY",
              "titles": [
                "GOVERNINGPERSON",
                "SECRETARY"
              ],
              "submitted": false,
              "source": [
                "642c8178-fe65-43e2-9f39-cab7453f08e8",
                "d8bae094-c6a1-40b2-83a5-b5c035d3d038"
              ]
            },
            {
              "name": "JAMES CHUMBLEY",
              "titles": [
                "GOVERNINGPERSON",
                "PRESIDENT"
              ],
              "submitted": false,
              "source": [
                "642c8178-fe65-43e2-9f39-cab7453f08e8",
                "d8bae094-c6a1-40b2-83a5-b5c035d3d038"
              ]
            },
            {
              "name": "BRYAN WITTLER                                                                                       ",
              "titles": [
                "REGISTERED AGENT"
              ],
              "submitted": false,
              "source": [
                "d8bae094-c6a1-40b2-83a5-b5c035d3d038"
              ]
            }
          ],
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "primary_address": {
      "name": "primary_address",
      "value": null,
      "alternatives": []
    },
    "sos_active": {
      "name": "sos_active",
      "value": true,
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": true,
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "sos_filings": {
      "name": "sos_filings",
      "value": [
        {
          "id": "7061ef94-01d5-4465-b676-25b1566073a7",
          "filing_date": "1988-09-08T00:00:00.000Z",
          "entity_type": "CORPORATION",
          "active": true,
          "state": "WA",
          "url": "https://ccfs.sos.wa.gov/#/AdvancedSearch",
          "filing_name": "WARM PRODUCTS, INC."
        },
        {
          "id": "5bbc6e26-d2ae-4659-acb8-a134c0825e4c",
          "filing_date": "2004-03-29T00:00:00.000Z",
          "entity_type": "CORPORATION",
          "active": true,
          "state": "NC",
          "url": "https://www.sosnc.gov/online_services/search/by_title/_lobbying",
          "filing_name": "Warm Products Inc."
        },
        {
          "id": "788e194c-2f3d-4aa1-95a5-0fea4c039de5",
          "filing_date": "1998-09-14T00:00:00.000Z",
          "entity_type": "CORPORATION",
          "active": false,
          "state": "MD",
          "url": "https://egov.maryland.gov/BusinessExpress/EntitySearch/BusinessInformation/F05088679",
          "filing_name": "WARM PRODUCTS, INC."
        },
        {
          "id": "2b3c0320-39d9-4e03-9367-34c9f20f2c44",
          "filing_date": "2005-04-11T00:00:00.000Z",
          "entity_type": "CORPORATION",
          "active": false,
          "state": "VT",
          "url": "https://bizfilings.vermont.gov/business/businesssearch",
          "filing_name": "WARM PRODUCTS INC."
        }
      ],
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": [
            {
              "id": "7061ef94-01d5-4465-b676-25b1566073a7",
              "filing_date": "1988-09-08T00:00:00.000Z",
              "entity_type": "CORPORATION",
              "active": true,
              "state": "WA",
              "url": "https://ccfs.sos.wa.gov/#/AdvancedSearch",
              "filing_name": "WARM PRODUCTS, INC."
            },
            {
              "id": "5bbc6e26-d2ae-4659-acb8-a134c0825e4c",
              "filing_date": "2004-03-29T00:00:00.000Z",
              "entity_type": "CORPORATION",
              "active": true,
              "state": "NC",
              "url": "https://www.sosnc.gov/online_services/search/by_title/_lobbying",
              "filing_name": "Warm Products Inc."
            },
            {
              "id": "788e194c-2f3d-4aa1-95a5-0fea4c039de5",
              "filing_date": "1998-09-14T00:00:00.000Z",
              "entity_type": "CORPORATION",
              "active": false,
              "state": "MD",
              "url": "https://egov.maryland.gov/BusinessExpress/EntitySearch/BusinessInformation/F05088679",
              "filing_name": "WARM PRODUCTS, INC."
            },
            {
              "id": "2b3c0320-39d9-4e03-9367-34c9f20f2c44",
              "filing_date": "2005-04-11T00:00:00.000Z",
              "entity_type": "CORPORATION",
              "active": false,
              "state": "VT",
              "url": "https://bizfilings.vermont.gov/business/businesssearch",
              "filing_name": "WARM PRODUCTS INC."
            }
          ],
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "sos_match": {
      "name": "sos_match",
      "value": "success",
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": "success",
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "sos_match_boolean": {
      "name": "sos_match_boolean",
      "value": true,
      "dependencies": [
        "sos_match"
      ],
      "alternatives": [
        {
          "value": true
        }
      ]
    },
    "tin": {
      "name": "tin",
      "value": "911425217",
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": "911425217",
          "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"
      },
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": {
            "status": "success",
            "message": "The IRS has a record for the submitted TIN and Business Name combination",
            "sublabel": "Found"
          },
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "tin_match_boolean": {
      "name": "tin_match_boolean",
      "value": false,
      "dependencies": [
        "tin_match"
      ],
      "alternatives": [
        {
          "value": false
        }
      ]
    },
    "veteran_owned": {
      "name": "veteran_owned",
      "value": null,
      "alternatives": []
    },
    "watchlist": {
      "name": "watchlist",
      "value": {
        "metadata": [
          {
            "id": "89b0caea-2023-43e0-b3d8-614e5f2d1935",
            "type": "watchlist_result",
            "metadata": {
              "abbr": "SDN",
              "title": "Specially Designated Nationals",
              "agency": "Office of Foreign Assets Control",
              "agency_abbr": "OFAC",
              "entity_name": "JOHNSON, Prince Yormie"
            }
          }
        ],
        "message": "1 Watchlists hit(s) have been identified"
      },
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": {
            "metadata": [
              {
                "id": "89b0caea-2023-43e0-b3d8-614e5f2d1935",
                "type": "watchlist_result",
                "metadata": {
                  "abbr": "SDN",
                  "title": "Specially Designated Nationals",
                  "agency": "Office of Foreign Assets Control",
                  "agency_abbr": "OFAC",
                  "entity_name": "JOHNSON, Prince Yormie"
                }
              }
            ],
            "message": "1 Watchlists hit(s) have been identified"
          },
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "watchlist_hits": {
      "name": "watchlist_hits",
      "value": null,
      "alternatives": []
    },
    "woman_owned": {
      "name": "woman_owned",
      "value": null,
      "alternatives": []
    },
    "year_established": {
      "name": "year_established",
      "value": "1988",
      "source.confidence": 0.95,
      "source.platformId": 16,
      "alternatives": [
        {
          "value": "1988",
          "source": 16,
          "confidence": 0.95
        }
      ]
    },
    "process_completion_data": {
      "all_kyb_processes_complete": true,
      "last_updated": "2025-05-14T20:30:58Z"
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

businessId
string
required

A universal identifier string unique to a particular business.

Examples:

"74cf5442-6f51-4666-bed8-0bee0ca793cc"

Response

200 - application/json; charset=utf-8

OK

The response is of type object.