Overview

You can manually override the KYB status of a business. You may want to do this, for example, if you receive a kyb.verification.warning response to a request to run KYB. Review the information to eliminate any possible errors. If you still receive an error, you can use the PATCH /businesses/{business_id}/verification-kyb operation with the approved status parameter to change the KYB status to accepted.

Updating the KYB status

To update the KYB status, use the POST /businesses/{business_id}/verification-kyb operation and provide the required status as shown in the table below.

Parameter	Description
`status` ^required	`approved` or `rejected`

An example of a request to update the KYB status to approved is shown below.

curl --request PATCH \
     --url https://sandbox.bond.tech/api/v0.1/businesses/002e0f0e-e39d-4351-876c-afcad30d9c37/verification-kyb \
     --header 'Authorization: <YOUR_AUTHORIZATION>' \
     --header 'Content-Type: application/json' \
     --header 'Identity: <YOUR_IDENTITY>' \
     --data '
{
     "status": "approved"
}

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://sandbox.bond.tech/api/v0.1/businesses/002e0f0e-e39d-4351-876c-afcad30d9c37/verification-kyb")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request["Identity"] = '<YOUR_IDENTITY>'
request["Authorization"] = '<YOUR_AUTHORIZATION>'
request.body = "{\"status\":\"approved\"}"

response = http.request(request)
puts response.read_body

const options = {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    Identity: '<YOUR_IDENTITY>',
    Authorization: '<YOUR_AUTHORIZATION>'
  },
  body: JSON.stringify({status: 'approved'})
};

fetch('https://sandbox.bond.tech/api/v0.1/businesses/002e0f0e-e39d-4351-876c-afcad30d9c37/verification-kyb', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import requests

url = "https://sandbox.bond.tech/api/v0.1/businesses/002e0f0e-e39d-4351-876c-afcad30d9c37/verification-kyb"

payload = {"status": "approved"}
headers = {
    "Content-Type": "application/json",
    "Identity": "<YOUR_IDENTITY>",
    "Authorization": "<YOUR_AUTHORIZATION>"
}

response = requests.request("PATCH", url, json=payload, headers=headers)

print(response.text)

var client = new RestClient("https://sandbox.bond.tech/api/v0.1/businesses/002e0f0e-e39d-4351-876c-afcad30d9c37/verification-kyb");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Identity", "<YOUR_IDENTITY>");
request.AddHeader("Authorization", "<YOUR_AUTHORIZATION>");
request.AddParameter("application/json", "{\"status\":\"approved\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"status\":\"approved\"}");
Request request = new Request.Builder()
  .url("https://sandbox.bond.tech/api/v0.1/businesses/002e0f0e-e39d-4351-876c-afcad30d9c37/verification-kyb")
  .patch(body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Identity", "<YOUR_IDENTITY>")
  .addHeader("Authorization", "<YOUR_AUTHORIZATION>")
  .build();

Response response = client.newCall(request).execute();

An example of a successful request to update the status to approved is shown below.

{
  "business_id": "12348579-5d05-4e3e-a5e3-e61e3a5b1234",
  "kyb_status": "approved"
}

For a complete specification and interactive examples, see Update KYB status in the Bond API Reference.