curl --request GET \
--url https://api.joinworth.com/integration/api/v1/verification/businesses/{businessId}/owners \
--header 'Authorization: Bearer <token>'{
"status": "success",
"message": "KYC Ownership Verification fetched successfully",
"data": [
{
"id": "47797fcf-09ff-46d7-b500-39141135c52f",
"external_id": "abc-123",
"title": "Director",
"first_name": "Leslie",
"last_name": "Knope",
"email": "admin@joinworth.com",
"mobile": "+12345678909",
"date_of_birth": "1989-07-22",
"address_apartment": null,
"address_line_1": "123 Main St.",
"address_line_2": null,
"address_city": "Pawnee",
"address_state": "IN",
"address_postal_code": "46001",
"address_country": "USA",
"created_at": "2024-05-16T11:34:14.545Z",
"created_by": "19ac7412-6c06-4742-8c52-38787c4e889a",
"updated_at": "2024-05-16T11:34:14.545Z",
"updated_by": "19ac7412-6c06-4742-8c52-38787c4e889a",
"business_id": "df3998ab-7111-4c01-9f4f-d9bd6467c3b6",
"owner_type": "CONTROL",
"ownership_percentage": "100.00",
"kyc_check": {
"name": {
"summary": "match"
},
"status": "success",
"address": {
"type": "no_data",
"po_box": "no_data",
"summary": "match"
},
"id_number": {
"summary": "match"
},
"phone_number": {
"summary": "match",
"area_code": "match"
},
"date_of_birth": {
"summary": "match"
}
},
"risk_check_result": {
"name": "match",
"address": {
"type": "no_data",
"po_box": "no_data",
"summary": "match"
},
"dob": "match",
"ssn": "match",
"phone": {
"summary": "match",
"area_code": "match",
"linked_services": [
"facebook",
"google",
"twitter",
"instagram",
"yahoo",
"whatsapp",
"telegram",
"viber",
"ok"
]
},
"email": {
"breach_count": 1,
"is_deliverable": "yes",
"linked_services": [
"facebook",
"google",
"twitter",
"instagram",
"yahoo",
"whatsapp",
"telegram",
"viber",
"ok"
],
"domain_is_custom": "no",
"last_breached_at": "2020-12-25",
"first_breached_at": "2020-12-25",
"domain_is_disposable": "no",
"domain_registered_at": "2010-12-25",
"domain_is_free_provider": "no",
"top_level_domain_is_suspicious": "no"
},
"user_interactions": null,
"fraud_ring_detected": null,
"bot_detected": null,
"synthetic_identity_risk_score": null,
"stolen_identity_risk_score": null,
"steps": {
"kyc_check": "success",
"accept_tos": "success",
"risk_check": "success",
"verify_sms": "not_applicable",
"selfie_check": "not_applicable",
"watchlist_screening": "not_applicable",
"documentary_verification": "success"
},
"ip_spam_list_count": 0,
"documents_verification": "success"
},
"identity_verification_attempted": true,
"idv": {
"document_integrity_results": [
{
"attempt": 1,
"plaid_document_status": "success",
"document_integrity_status": "clear",
"details": {
"authenticity": "match",
"image_quality": "high",
"aamva_is_verified": null
}
}
]
}
}
]
}KYC Ownership Verification
Know Your Customer: returns a list of individuals with ownership or control, including their submitted personal details and verification results.
Prior to utilizing this service, one must first obtain a businessID by creating a business via the Add business service. For more details on using these endpoints, please reference the Getting Started guide.
curl --request GET \
--url https://api.joinworth.com/integration/api/v1/verification/businesses/{businessId}/owners \
--header 'Authorization: Bearer <token>'{
"status": "success",
"message": "KYC Ownership Verification fetched successfully",
"data": [
{
"id": "47797fcf-09ff-46d7-b500-39141135c52f",
"external_id": "abc-123",
"title": "Director",
"first_name": "Leslie",
"last_name": "Knope",
"email": "admin@joinworth.com",
"mobile": "+12345678909",
"date_of_birth": "1989-07-22",
"address_apartment": null,
"address_line_1": "123 Main St.",
"address_line_2": null,
"address_city": "Pawnee",
"address_state": "IN",
"address_postal_code": "46001",
"address_country": "USA",
"created_at": "2024-05-16T11:34:14.545Z",
"created_by": "19ac7412-6c06-4742-8c52-38787c4e889a",
"updated_at": "2024-05-16T11:34:14.545Z",
"updated_by": "19ac7412-6c06-4742-8c52-38787c4e889a",
"business_id": "df3998ab-7111-4c01-9f4f-d9bd6467c3b6",
"owner_type": "CONTROL",
"ownership_percentage": "100.00",
"kyc_check": {
"name": {
"summary": "match"
},
"status": "success",
"address": {
"type": "no_data",
"po_box": "no_data",
"summary": "match"
},
"id_number": {
"summary": "match"
},
"phone_number": {
"summary": "match",
"area_code": "match"
},
"date_of_birth": {
"summary": "match"
}
},
"risk_check_result": {
"name": "match",
"address": {
"type": "no_data",
"po_box": "no_data",
"summary": "match"
},
"dob": "match",
"ssn": "match",
"phone": {
"summary": "match",
"area_code": "match",
"linked_services": [
"facebook",
"google",
"twitter",
"instagram",
"yahoo",
"whatsapp",
"telegram",
"viber",
"ok"
]
},
"email": {
"breach_count": 1,
"is_deliverable": "yes",
"linked_services": [
"facebook",
"google",
"twitter",
"instagram",
"yahoo",
"whatsapp",
"telegram",
"viber",
"ok"
],
"domain_is_custom": "no",
"last_breached_at": "2020-12-25",
"first_breached_at": "2020-12-25",
"domain_is_disposable": "no",
"domain_registered_at": "2010-12-25",
"domain_is_free_provider": "no",
"top_level_domain_is_suspicious": "no"
},
"user_interactions": null,
"fraud_ring_detected": null,
"bot_detected": null,
"synthetic_identity_risk_score": null,
"stolen_identity_risk_score": null,
"steps": {
"kyc_check": "success",
"accept_tos": "success",
"risk_check": "success",
"verify_sms": "not_applicable",
"selfie_check": "not_applicable",
"watchlist_screening": "not_applicable",
"documentary_verification": "success"
},
"ip_spam_list_count": 0,
"documents_verification": "success"
},
"identity_verification_attempted": true,
"idv": {
"document_integrity_results": [
{
"attempt": 1,
"plaid_document_status": "success",
"document_integrity_status": "clear",
"details": {
"authenticity": "match",
"image_quality": "high",
"aamva_is_verified": null
}
}
]
}
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.worthai.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique universal identifier string for the business.
Response
OK
Indicates whether the request succeeded or failed.
success, fail "success"
Descriptive message about the result of the operation.
"KYC Ownership Verification fetched successfully"
List of ownership verification records.
Show child attributes
Show child attributes
Was this page helpful?