# Corporates

Corporates are identities representing companies. Once on-boarded, Corporates can create and manage their own instruments via your application.

## Create a corporate

 - [POST /corporates](https://api.weavr.io/products/multi/openapi/corporates/corporatecreate.md): Create a corporate identity for a business customer.  The information provided must be accurate and will be passed on for KYB verification with our partner.

## Get a corporate

 - [GET /corporates](https://api.weavr.io/products/multi/openapi/corporates/corporateget.md): Retrieve the details of the logged-in corporate.

## Update a corporate

 - [PATCH /corporates](https://api.weavr.io/products/multi/openapi/corporates/corporateupdate.md): Update the details of the logged-in corporate identity.

The following Corporate details are verified during due diligence (KYB) and cannot be updated via the API once the Corporate has been verified:
  - Root User Name
  - Root User Surname
  - Root User Email
  - Root User Mobile Country Code
  - Root User Mobile Number
  - Business Address
  - Date of birth

If these details need to be changed after due diligence is completed, please contact Customer Support to restart the Due Diligence process.

## Send an email verification code to the root user

 - [POST /corporates/verification/email/send](https://api.weavr.io/products/multi/openapi/corporates/corporaterootuseremailverificationcodesend.md): The first step in verifying a root user's email. The root user whose email address is to be verified is sent an email containing a randomly generated code.

This code must then be provided in the _corporateRootUserEmailVerify_ operation to verify the root user's email address.

_Note that on the Sandbox Environment, the verificationCode is always set to \"123456\"._

## Verify email of the root user

 - [POST /corporates/verification/email/verify](https://api.weavr.io/products/multi/openapi/corporates/corporaterootuseremailverify.md): The second step in verifying the root user's email. The randomly generated code sent to the root user via
email, using the _corporateRootUserEmailVerificationCodeSend_ operation, is submitted here to verify the root user's email.

This is needed as part of the verification process for basic due diligence.

_Note that on the Sandbox Environment, the verificationCode is always set to \"123456\"._

## Start KYB for a corporate

 - [POST /corporates/kyb](https://api.weavr.io/products/multi/openapi/corporates/corporatekybstart.md): Corporates need to complete due diligence (KYB) before they can create instruments and perform transactions.

This operation initiates the due diligence process for the logged-in corporate.

Due Diligence is handled by a KYB provider - you will need to embed the KYB UI Component in your application so that the Corporate will be able to perform the KYB process.

To initialise the KYB UI Component, you need a reference that is given you in the response of this operation.

## Get KYB for a corporate

 - [GET /corporates/kyb](https://api.weavr.io/products/multi/openapi/corporates/corporatekybget.md): Returns the KYB status for the logged-in corporate.

## Charge fee to a corporate

 - [POST /corporates/fees/charge](https://api.weavr.io/products/multi/openapi/corporates/corporatechargefee.md): Charge a fee to the corporate identified by the auth token, based on a pre-defined custom fee. Custom fees can be configured in the Multi Portal.

The fees collected will be deposited into your Revenue Account. The balance and transaction history of your revenue account can be viewed in the Multi Portal.