Skip to main content
GET
/
facts
/
business
/
{businessId}
/
kyb
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": "success",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "dependencies": [
        "primary_address, addresses"
      ],
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": "success",
          "confidence": 123
        }
      ]
    },
    "address_match_boolean": {
      "name": "address_match_boolean",
      "value": true,
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "dependencies": [
        "address_match"
      ],
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": true
        }
      ]
    },
    "address_registered_agent": {
      "name": "address_registered_agent",
      "value": {},
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "alternatives": [
        {
          "value": true
        }
      ]
    },
    "address_verification": {
      "name": "address_verification",
      "value": {
        "addresses": [
          "<string>"
        ],
        "status": "success",
        "message": "Match identified to the submitted Office Address",
        "label": "Office Address",
        "sublabel": "Verified"
      },
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": {
            "addresses": [
              "<string>"
            ],
            "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,
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "dependencies": [
        "<string>"
      ],
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        true
      ]
    },
    "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": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": [
            "<string>"
          ],
          "source": 123,
          "confidence": 0.95,
          "updatedAt": "2025-09-29T23:51:18.445Z"
        }
      ],
      "isNormalized": true
    },
    "addresses_deliverable": {
      "name": "address_deliverable",
      "value": "354 Circle Ct, Bronx, NY, 10468",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "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": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": [
            "<string>"
          ],
          "source": 123,
          "confidence": 0.95,
          "updatedAt": "2025-09-29T23:51:18.445Z"
        }
      ],
      "isNormalized": true
    },
    "addresses_submitted": {
      "name": "addresses_submitted",
      "value": [
        "Suite #300 10 Laurel Avenue , Wellesley, MA 02481"
      ],
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {}
      ]
    },
    "corporation": {
      "name": "corporation",
      "value": "Private",
      "schema": {},
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {}
      ]
    },
    "countries": {
      "name": "countries",
      "value": [
        "US"
      ],
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "dependencies": [
        "addresses"
      ],
      "description": "<string>",
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {}
      ]
    },
    "dba_found": {
      "name": "dba_found",
      "value": [
        "Example Business PC",
        "Example Business LLC",
        "Example Business",
        "EXAMPLE BUSINESS, LLC"
      ],
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": [
            "<string>"
          ],
          "source": 123,
          "confidence": 0.95,
          "updatedAt": "2025-09-29T23:51:18.445Z"
        }
      ]
    },
    "email": {
      "name": "email",
      "value": "[email protected]",
      "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": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {}
      ]
    },
    "formation_date": {
      "name": "formation_date",
      "value": "2012-08-23",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": "2023-11-07T05:31:56Z",
          "source": 123,
          "confidence": 123,
          "updatedAt": "2025-09-29T23:51:18.445Z"
        }
      ]
    },
    "formation_state": {
      "name": "formation_state",
      "value": "MA",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": "<string>",
          "source": 123,
          "confidence": 123
        }
      ]
    },
    "idv_passed": {
      "name": "idv_passed",
      "value": "<unknown>",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "number"
      },
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {}
      ],
      "dependencies": [
        "idv_status"
      ]
    },
    "idv_passed_boolean": {
      "name": "idv_passed_boolean",
      "value": "<unknown>",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "boolean"
      },
      "source": "<unknown>",
      "override": {},
      "alternatives": [
        {}
      ],
      "dependencies": [
        "idv_passed"
      ]
    },
    "idv_status": {
      "name": "idv_status",
      "value": "<unknown>",
      "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": "<unknown>",
      "override": {},
      "alternatives": [
        {}
      ]
    },
    "is_sole_prop": {
      "name": "is_sole_prop",
      "value": "<unknown>",
      "schema": "<unknown>",
      "source": "<unknown>",
      "override": {},
      "alternatives": [
        {}
      ],
      "dependencies": [
        "tin_submitted",
        "idv_passed_boolean"
      ]
    },
    "kyb_submitted": {
      "name": "kyb_submitted",
      "value": true,
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "dependencies": [
        "addresses"
      ],
      "source.platformId": 123,
      "alternatives": [
        {}
      ]
    },
    "legal_name": {
      "name": "legal_name",
      "value": "EXAMPLE BUSINESS, LLC",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": "<string>",
          "source": 123,
          "confidence": 123,
          "updatedAt": "2025-09-29T23:51:18.445Z"
        }
      ]
    },
    "minority_owned": {
      "name": "minority_owned",
      "value": "<unknown>",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      },
      "source": "<unknown>",
      "override": {},
      "alternatives": [
        "<string>"
      ]
    },
    "name_match": {
      "name": "name_match",
      "value": {
        "status": "success",
        "message": "Match Found",
        "sublabel": ""
      },
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": {
            "status": "success",
            "message": "Match identified to the submitted Business Name",
            "sublabel": "Verified"
          },
          "source": 123,
          "confidence": 123
        }
      ]
    },
    "name_match_boolean": {
      "name": "name_match_boolean",
      "value": true,
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "dependencies": [
        "name_match"
      ],
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": true
        }
      ]
    },
    "names_found": {
      "name": "names_found",
      "value": [
        "Example Business PC",
        "Example Business LLC",
        "Example Business",
        "EXAMPLE BUSINESS, LLC"
      ],
      "schema": "<unknown>",
      "source": "<unknown>",
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {}
      ]
    },
    "names_submitted": {
      "name": "names_submitted",
      "value": [
        {
          "name": "<string>",
          "submitted": true
        }
      ],
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {}
      ]
    },
    "people": {
      "name": "people",
      "value": [
        "<unknown>"
      ],
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        "<string>"
      ]
    },
    "phone_found": {
      "name": "phone_found",
      "value": [
        "<string>"
      ],
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "source": {
        "confidence": "<unknown>",
        "platformId": "<unknown>"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {}
      ],
      "isNormalized": true
    },
    "primary_address": {
      "name": "primary_address",
      "value": "<unknown>",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "dependencies": [
        "addresses"
      ],
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        "<string>"
      ]
    },
    "sos_active": {
      "name": "<string>",
      "value": true,
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "dependencies": [
        "sos_filings"
      ],
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": true,
          "source": 123,
          "confidence": 123
        }
      ]
    },
    "sos_filings": {
      "name": "sos_filings",
      "value": [
        "<unknown>"
      ],
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        "<string>"
      ]
    },
    "sos_match": {
      "name": "<string>",
      "value": "success",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": "<string>",
          "source": 123,
          "confidence": 123
        }
      ]
    },
    "sos_match_boolean": {
      "name": "<string>",
      "value": true,
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "dependencies": [
        "sos_match"
      ],
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": true
        }
      ]
    },
    "stock_symbol": {
      "name": "<string>",
      "value": "<string>",
      "schema": "<unknown>",
      "source": {},
      "override": {},
      "alternatives": [
        "<string>"
      ]
    },
    "tin": {
      "name": "<string>",
      "value": "<string>",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": "<string>",
          "source": 123,
          "confidence": 123
        }
      ]
    },
    "tin_match": {
      "name": "<string>",
      "value": {
        "status": "success",
        "message": "<string>",
        "sublabel": "<string>"
      },
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": {
            "status": "<string>",
            "message": "<string>",
            "sublabel": "<string>"
          },
          "source": 123,
          "confidence": 123
        }
      ]
    },
    "tin_match_boolean": {
      "name": "<string>",
      "value": true,
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "dependencies": [
        "<string>"
      ],
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": true
        }
      ]
    },
    "tin_submitted": {
      "name": "<string>",
      "value": "<string>",
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "description": "<string>",
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": "<string>",
          "source": 123,
          "confidence": 123
        }
      ]
    },
    "veteran_owned": {
      "name": "veteran_owned",
      "value": "<unknown>",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      },
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "alternatives": [
        "<string>"
      ]
    },
    "watchlist": "<unknown>",
    "watchlist_hits": {
      "name": "<string>",
      "value": 123,
      "schema": "<unknown>",
      "source": {
        "confidence": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "dependencies": [
        "watchlist"
      ],
      "alternatives": [
        "<string>"
      ]
    },
    "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": 123,
        "platformId": 123
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": [
            "<string>"
          ],
          "source": 123,
          "confidence": 0.95,
          "updatedAt": "2025-09-29T23:51:18.445Z"
        }
      ],
      "isNormalized": true
    },
    "woman_owned": {
      "name": "<string>",
      "value": "<unknown>",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      },
      "source": "<unknown>",
      "override": {},
      "alternatives": [
        "<string>"
      ]
    },
    "year_established": {
      "name": "<string>",
      "value": "2012",
      "schema": {},
      "source": {
        "confidence": 123,
        "platformId": 123,
        "updatedAt": "2025-09-29T23:51:18.445Z"
      },
      "override": {},
      "source.confidence": 123,
      "source.platformId": 123,
      "alternatives": [
        {
          "value": "2012",
          "source": 123,
          "confidence": 123,
          "updatedAt": "2025-09-29T23:51:18.445Z"
        }
      ]
    },
    "process_completion_data": {
      "all_kyb_processes_complete": true,
      "last_updated": "<string>"
    }
  }
}

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.

Example:

"ac4d4ebc-8bb9-4927-8fd5-6ea677afeed2"

Response

200 - application/json; charset=utf-8

OK

status
enum<string>

Indicates whether the request succeeded or failed.

Available options:
success,
fail
message
string

Descriptive message about the result of the operation.

Example:

"Business KYB details fetched successfully"

data
KYBData · object