Create a business entry for the current user

POST /users/{user_id}/kyc/businesses

Create a business entry for the current user. 'second_country_of_taxation' and 'second_tax_id_number' attributes are required only when exclusively_taxable_in_country_of_taxation is set to false

Path parameters

user_id string Required

User id

Body Required

Business information

legal_name string Required
tax_id_number string Required
legal_form string Required
register_number string Required
country_of_taxation string Required

two-letter country codes in ISO 3166-1 alpha-2 format
second_country_of_taxation string Required

two-letter country codes in ISO 3166-1 alpha-2 format
second_tax_id_number string Required
exclusively_taxable_in_country_of_taxation boolean Required

Responses

201

Business created and returned
Hide response attributes Show response attributes object
- id string(uuid)
- name string
- legal_name string
- tax_id_number string
- legal_form string
- register_number string
- country_of_taxation string
  
  two-letter country codes in ISO 3166-1 alpha-2 format
- second_country_of_taxation string
  
  two-letter country codes in ISO 3166-1 alpha-2 format
- second_tax_id_number string
- exclusively_taxable_in_country_of_taxation boolean
401

Authorization information is missing or invalid.
422

Request body has errors or invalid.

POST /users/{user_id}/kyc/businesses

curl \
 -X POST https://client-subdomain.bitbond.net/api/v1/users/{user_id}/kyc/businesses \
 -H "Content-Type: application/json" \
 -d '{"legal_name":"string","tax_id_number":"string","legal_form":"string","register_number":"string","country_of_taxation":"string","second_country_of_taxation":"string","second_tax_id_number":"string","exclusively_taxable_in_country_of_taxation":true}'

Request example

{
  "legal_name": "string",
  "tax_id_number": "string",
  "legal_form": "string",
  "register_number": "string",
  "country_of_taxation": "string",
  "second_country_of_taxation": "string",
  "second_tax_id_number": "string",
  "exclusively_taxable_in_country_of_taxation": true
}

Request examples

{
  "legal_name": "string",
  "tax_id_number": "string",
  "legal_form": "string",
  "register_number": "string",
  "country_of_taxation": "string",
  "second_country_of_taxation": "string",
  "second_tax_id_number": "string",
  "exclusively_taxable_in_country_of_taxation": true
}

Response examples (201)

{
  "id": "string",
  "name": "string",
  "legal_name": "string",
  "tax_id_number": "string",
  "legal_form": "string",
  "register_number": "string",
  "country_of_taxation": "string",
  "second_country_of_taxation": "string",
  "second_tax_id_number": "string",
  "exclusively_taxable_in_country_of_taxation": true
}

Response examples (201)

{
  "id": "string",
  "name": "string",
  "legal_name": "string",
  "tax_id_number": "string",
  "legal_form": "string",
  "register_number": "string",
  "country_of_taxation": "string",
  "second_country_of_taxation": "string",
  "second_tax_id_number": "string",
  "exclusively_taxable_in_country_of_taxation": true
}