> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ach.netevia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update KYB

> Suggest Edits

With this request, you can update the KYB information for an existing onboarded business. You will need to provide all KYB-related details using this API and ensure that the business's KYB status is either null or Failed.

<Info>
  This route is secured with **processor** and **vendor** token authentication.
</Info>

### Endpoint

PUT   **/3p/api/v2/users/\{uuid}/kyb**

 

### Example

<CodeGroup>
  ```json Example theme={"system"}
  {
    "first_name": "Jack",
    "last_name": "Jones",
    "email": "[email protected]",
    "phone": "2457856494",
    "business": {
      "name": "Jack Inc.",
      "tin": "958455211",
      "trading_name": "Jack Corp.",
      "entity_type": "Sole Trader",
      "incorporation_date": "2024-03-01",
      "incorporation_state": "CO",
      "address_type": "Registered",
      "address": {
        "line_1": "10554",
        "city": "spaces",
        "state": "CA",
        "zip": "80127"
      }
    }
  }
  ```
</CodeGroup>

### Body Parameters

| Fields                                            | Type                 | Is Required | Description                                                                                                                                                                             |
| ------------------------------------------------- | -------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **first\_name**                                   | string               | Yes         | Max characters: 56 *Only accepts letters (a-z, A-Z, À-ÿ), numbers (0-9), hyphens (-), periods (.), apostrophes ('), and spaces.*                                                        |
| **last\_name**                                    | string               | Yes         | Max characters: 56 *Only accepts letters (a-z, A-Z, À-ÿ), numbers (0-9), hyphens (-), periods (.), apostrophes ('), and spaces.*                                                        |
| **email**                                         | string               | Yes         |                                                                                                                                                                                         |
| **phone**                                         | string               | Yes         | without prefix +1 *for eg. 2092370450*                                                                                                                                                  |
| **business.name**                                 | string               | Yes         | Legal name of the business *Max characters: 64 Only accepts letters (a-z, A-Z), numbers (0-9), ampersand(&), hyphens (-), periods (.), apostrophes ('), comma(,), plus (+) and spaces.* |
| **business.tin**                                  | string               | Yes         | *must consist of 9 digit without any special character*                                                                                                                                 |
| **business.trading\_name**                        | string               | Yes         | Trading name of the business                                                                                                                                                            |
| **business.entity\_type**                         | string               | Yes         | Business entity type. For eg. Sole Trader, Limited Company etc.                                                                                                                         |
| **business.incorporation\_date**                  | date:Y-m-d           | Yes         | Date when the company was incorporated                                                                                                                                                  |
| **business.incorporation\_state**                 | string(2)            | Yes         | State where the company was incorporated (US only)                                                                                                                                      |
| **business.industry**                             | string               | No          | Nature of business                                                                                                                                                                      |
| **business.industry\_classification.code\_type**  | string               |             | Type of industry classification code. eg. SIC etc. Required if `industry_classification` exists                                                                                         |
| **business.industry\_classification.codes**       | array string         |             | Industry classification codes Required if `industry_classification` exists                                                                                                              |
| **business.industry\_classification.description** | string               |             | Description of the industry classification code Required if `industry_classification` exists                                                                                            |
| **business.source\_of\_wealth**                   | string               | No          | Source of wealth of the company                                                                                                                                                         |
| **business.source\_of\_funds**                    | string               | No          | Source of initial deposit of the company                                                                                                                                                |
| **business.first\_transaction\_completed\_at**    | datetime:Y-m-d H:i:s | No          | Original timestamp of when the person completed their first transaction                                                                                                                 |
| **business.product\_type**                        | string               | No          |                                                                                                                                                                                         |
| **business.registered\_as\_inactive**             | boolean              | No          |                                                                                                                                                                                         |
| **business.address\_type**                        | string               | Yes         | Type of address. For eg. Registered, Trading, Legal etc.                                                                                                                                |
| **business.address.line\_1**                      | string               | Yes         |                                                                                                                                                                                         |
| **business.address.city**                         | string               | Yes         |                                                                                                                                                                                         |
| **business.address.state**                        | string(2)            | Yes         |                                                                                                                                                                                         |
| **business.address.zip**                          | string               | Yes         | *must consist of 5 digit without any special character*                                                                                                                                 |

### Response

<CodeGroup>
  ```json Success(200) theme={"system"}
  {
      "status": true,
      "message": "The business KYB has been updated.",
      "data": null,
      "errors": null,
      "error_code": null
  }
  ```
</CodeGroup>

***

* [Table of Contents](#)

* * [Endpoint](#endpoint)
  * [Example](#example)
  * [Body Parameters](#body-parameters)
  * [Response](#response)