POST

Switch verification flow for an existing IDV

Switches an existing IDV record from one verification flow to another (e.g. penny-drop to video-id). Only allowed when the current review is pending or action_required (null or RED+RETRY). Returns a fresh WebSDK link for the new level.

Path Params

idvId string required

The IDV record ID

Body Params

object

verificationType string enum required

The verification flow to switch to.

penny-dropvideo-idliveness-only
includeSdkToken boolean

When true, generates and returns a Sumsub Mobile SDK access token alongside the WebSDK URL. Not supported for penny-drop verification — returns 400 if combined with verificationType 'penny-drop' (MobileSDK does not support the penny-drop flow).

Responses

200

Response Body

object

url string required
expiresAt string required
sdkToken string

400

Response Body

object

error string required

Error message

403

Response Body

object

error string required

Error message

404

Response Body

object

error string required

Error message

409

Response Body

object

error string required

Error message

500

Response Body

object

error string required

Error message

curl --request POST \ --url 'https://app.bitgo-test.com/api/sumsub-service/v1/idv/idvId/change-verification-type' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{,"verificationType":"penny-drop","includeSdkToken":true}'

const url = 'https://app.bitgo-test.com/api/sumsub-service/v1/idv/idvId/change-verification-type'; const options = { method: 'POST', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'content-type': 'application/json'}, body: JSON.stringify({,"verificationType":"penny-drop","includeSdkToken":true}) }; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/sumsub-service/v1/idv/idvId/change-verification-type") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' request["content-type"] = 'application/json' request.body = '{,"verificationType":"penny-drop","includeSdkToken":true}' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://app.bitgo-test.com/api/sumsub-service/v1/idv/idvId/change-verification-type', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'content-type' => 'application/json', ], 'body' => '{,"verificationType":"penny-drop","includeSdkToken":true}', ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/sumsub-service/v1/idv/idvId/change-verification-type" payload = {,"verificationType":"penny-drop","includeSdkToken":true} headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "content-type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)