Submit the case

curl --request POST \
  --url https://api.example.com/api/v4/kyb/widget/{publicId}/submit

const options = {method: 'POST'};

fetch('https://api.example.com/api/v4/kyb/widget/{publicId}/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v4/kyb/widget/{publicId}/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v4/kyb/widget/{publicId}/submit"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v4/kyb/widget/{publicId}/submit")

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

request = Net::HTTP::Post.new(url)

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

{
  "id": "019f179b-0fa7-72c8-818e-819652540477",
  "status": "under_review",
  "submitted_at": "2026-06-30T08:15:00Z"
}

{
  "code": "case_not_found",
  "message": "Case not found"
}

{
  "code": "case_locked",
  "message": "Case is locked and cannot be modified"
}

{
  "code": "incomplete_sections",
  "message": "Some sections are incomplete or invalid",
  "sections": {
    "business": [
      {
        "code": "required",
        "field": "legal_name",
        "message": "This field is required"
      }
    ],
    "documents": [
      {
        "code": "document_required",
        "field": "tax",
        "message": "A required document is missing"
      }
    ],
    "people": [
      {
        "code": "min_one_owner_required",
        "message": "At least one beneficial owner must be added"
      },
      {
        "code": "required",
        "field": "ssn",
        "message": "This field is required",
        "owner_id": "019f18a0-0000-7000-8000-0123456789ab"
      },
      {
        "code": "document_required",
        "field": "id_document",
        "message": "A required document is missing",
        "owner_id": "019f18a0-0000-7000-8000-0123456789ab"
      },
      {
        "code": "ownership_total_must_be_100",
        "field": "ownership_pct",
        "message": "Ownership percentages of all owners must add up to 100%"
      }
    ],
    "representative": [
      {
        "code": "kyc_required",
        "message": "Identity verification (KYC) must be completed",
        "person_id": "0195c1f0-1234-7000-8000-0123456789ab"
      }
    ],
    "volume_banking": [
      {
        "code": "required",
        "field": "annual_volume",
        "message": "This field is required"
      }
    ]
  }
}

KYB Widget

Submit the case

Runs hard validation across all required sections: required and conditionally-required fields, at least one beneficial owner, per-owner completeness (every required field of the parties form template plus an attached government ID) and every required document slot including the representative’s government ID. On success locks every field and transitions draft to under_review. Idempotent: submitting an already under_review or completed case returns its current state.

This is also the re-submit for an open information request (the case is in_remediation): it additionally requires every requested field to be non-empty, answering the request all at once even though the values autosave as they are typed. A request with an empty target left is a 422 remediation_incomplete whose param names the first one, so the widget can scroll to it. The representative KYC gate is not re-applied on a re-submit. A requested document group answers the same way by holding a file, whether that file is a fresh upload or the one that was already there. Answering the request resolves it, re-locks the fields and mints a fresh check run.

A CUSTOM ask is answered on the ask itself and its resp_type says how: text needs answer_text, file needs at least one file uploaded against the ask, text+file needs both. Only an ask the officer marked required holds the re-submit up, and there param is the ask’s label rather than a section.field pair, since it has no catalog keys to be named by.

POST

api

kyb

widget

{publicId}

submit

Submit the case

curl --request POST \
  --url https://api.example.com/api/v4/kyb/widget/{publicId}/submit

const options = {method: 'POST'};

fetch('https://api.example.com/api/v4/kyb/widget/{publicId}/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v4/kyb/widget/{publicId}/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v4/kyb/widget/{publicId}/submit"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v4/kyb/widget/{publicId}/submit")

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

request = Net::HTTP::Post.new(url)

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

{
  "id": "019f179b-0fa7-72c8-818e-819652540477",
  "status": "under_review",
  "submitted_at": "2026-06-30T08:15:00Z"
}

{
  "code": "case_not_found",
  "message": "Case not found"
}

{
  "code": "case_locked",
  "message": "Case is locked and cannot be modified"
}

{
  "code": "incomplete_sections",
  "message": "Some sections are incomplete or invalid",
  "sections": {
    "business": [
      {
        "code": "required",
        "field": "legal_name",
        "message": "This field is required"
      }
    ],
    "documents": [
      {
        "code": "document_required",
        "field": "tax",
        "message": "A required document is missing"
      }
    ],
    "people": [
      {
        "code": "min_one_owner_required",
        "message": "At least one beneficial owner must be added"
      },
      {
        "code": "required",
        "field": "ssn",
        "message": "This field is required",
        "owner_id": "019f18a0-0000-7000-8000-0123456789ab"
      },
      {
        "code": "document_required",
        "field": "id_document",
        "message": "A required document is missing",
        "owner_id": "019f18a0-0000-7000-8000-0123456789ab"
      },
      {
        "code": "ownership_total_must_be_100",
        "field": "ownership_pct",
        "message": "Ownership percentages of all owners must add up to 100%"
      }
    ],
    "representative": [
      {
        "code": "kyc_required",
        "message": "Identity verification (KYC) must be completed",
        "person_id": "0195c1f0-1234-7000-8000-0123456789ab"
      }
    ],
    "volume_banking": [
      {
        "code": "required",
        "field": "annual_volume",
        "message": "This field is required"
      }
    ]
  }
}

Path Parameters

publicId

string

required

KYB case public id.

Response

Case submitted.

SubmitResponse schema

string

Example:

"0195c1f0-1234-7000-8000-0123456789ab"

status

string

Example:

"under_review"

submitted_at

string<date-time> | null

API documentation

KYB

KYT

Submit the case

Path Parameters

Response