Create a business owner for the current business user
Create a business owner for the current business user.
Path parameters
-
User id
Body Required
Business owner information
-
tax_id_number string
-
two-letter country codes in ISO 3166-1 alpha-2 format
-
title string
-
name_affix string
-
name_at_birth string
-
second_citizenship string
two-letter country codes in ISO 3166-1 alpha-2 format
-
two-letter country codes in ISO 3166-1 alpha-2 format
POST
/users/{user_id}/kyc/business_owners
curl \
-X POST https://client-subdomain.bitbond.net/api/v1/users/{user_id}/kyc/business_owners \
-H "Content-Type: application/json" \
-d '{"tax_id_number":"string","first_name":"string","last_name":"string","citizenship":"string","date_of_birth":"string","title":"string","name_affix":"string","name_at_birth":"string","second_citizenship":"string","country_of_taxation":"string","share":42.0}'
Request example
{
"tax_id_number": "string",
"first_name": "string",
"last_name": "string",
"citizenship": "string",
"date_of_birth": "string",
"title": "string",
"name_affix": "string",
"name_at_birth": "string",
"second_citizenship": "string",
"country_of_taxation": "string",
"share": 42.0
}
Request examples
{
"tax_id_number": "string",
"first_name": "string",
"last_name": "string",
"citizenship": "string",
"date_of_birth": "string",
"title": "string",
"name_affix": "string",
"name_at_birth": "string",
"second_citizenship": "string",
"country_of_taxation": "string",
"share": 42.0
}
Response examples (201)
{
"id": "string",
"user_id": "string",
"company_role": "string",
"tax_id_number": "string",
"first_name": "string",
"last_name": "string",
"phone_number": "string",
"citizenship": "string",
"country_of_birth": "string",
"date_of_birth": "string",
"video_identification_completed_at": "string",
"place_of_birth": "string",
"family_status": "string",
"gender": "string",
"not_us_income_tax": true,
"trading_on_behalf_of_self": true,
"title": "string",
"name_affix": "string",
"mifid_status": "skipped",
"name_at_birth": "string",
"second_citizenship": "string",
"country_of_taxation": "string",
"second_country_of_taxation": "string",
"second_tax_id_number": "string",
"share": 42.0,
"sole_right_of_representation": true,
"exclusively_taxable_in_country_of_taxation": true,
"type": "string",
"video_identification_completed": true,
"address": {
"id": "string",
"street_additional": "string",
"city": "string",
"country": "string",
"state": "string",
"street": "string",
"number": "string",
"zipcode": "string"
},
"video_identifications": [
{
"id": "string",
"identity_id": "string",
"idnow_id": "string",
"redirect_url": "string",
"statuses": [
"string"
],
"data": {},
"url": "string",
"has_files": true,
"completed": true,
"success": true,
"rejected": true,
"pending": true,
"reason": "string",
"identificationtime": "string",
"status": "string"
}
],
"attachments": [
{
"id": "string",
"file": {},
"filename": "string",
"document_type": "string",
"document_id_number": "string",
"issued_at": "string",
"expires_at": "string",
"issuing_authority": "string",
"issuing_country": "string",
"content_type": "string"
}
],
"term": {
"custody_wallet_terms_acceptance": true,
"custody_wallet_privacy_acceptance": true
}
}
Response examples (201)
{
"id": "string",
"user_id": "string",
"company_role": "string",
"tax_id_number": "string",
"first_name": "string",
"last_name": "string",
"phone_number": "string",
"citizenship": "string",
"country_of_birth": "string",
"date_of_birth": "string",
"video_identification_completed_at": "string",
"place_of_birth": "string",
"family_status": "string",
"gender": "string",
"not_us_income_tax": true,
"trading_on_behalf_of_self": true,
"title": "string",
"name_affix": "string",
"mifid_status": "skipped",
"name_at_birth": "string",
"second_citizenship": "string",
"country_of_taxation": "string",
"second_country_of_taxation": "string",
"second_tax_id_number": "string",
"share": 42.0,
"sole_right_of_representation": true,
"exclusively_taxable_in_country_of_taxation": true,
"type": "string",
"video_identification_completed": true,
"address": {
"id": "string",
"street_additional": "string",
"city": "string",
"country": "string",
"state": "string",
"street": "string",
"number": "string",
"zipcode": "string"
},
"video_identifications": [
{
"id": "string",
"identity_id": "string",
"idnow_id": "string",
"redirect_url": "string",
"statuses": [
"string"
],
"data": {},
"url": "string",
"has_files": true,
"completed": true,
"success": true,
"rejected": true,
"pending": true,
"reason": "string",
"identificationtime": "string",
"status": "string"
}
],
"attachments": [
{
"id": "string",
"file": {},
"filename": "string",
"document_type": "string",
"document_id_number": "string",
"issued_at": "string",
"expires_at": "string",
"issuing_authority": "string",
"issuing_country": "string",
"content_type": "string"
}
],
"term": {
"custody_wallet_terms_acceptance": true,
"custody_wallet_privacy_acceptance": true
}
}