GET

Get Sumsub IDV status

Returns the current identity verification status for the given IDV record. Does not refresh the WebSDK URL — call POST /v1/idv to initiate or retry.

Path Params

idvId string required

The IDV record ID

Responses

200

Response Body

object

idvId string required
status string enum required

pendingaction_requiredapprovedrejected
verificationType string enum required

penny-dropvideo-idliveness-only
userId string required
enterpriseId string required
organizationId string nullable required
rejectLabels array of strings nullable required

403

Response Body

object

error string required

Error message

404

Response Body

object

error string required

Error message

500

Response Body

object

error string required

Error message

const url = 'https://app.bitgo-test.com/api/sumsub-service/v1/idv/idvId'; const options = {method: 'GET', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}}; 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") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://app.bitgo-test.com/api/sumsub-service/v1/idv/idvId', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', ], ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/sumsub-service/v1/idv/idvId" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN" } response = requests.get(url, headers=headers) print(response.text)

{ "idvId": "string", "status": "pending", "verificationType": "penny-drop", "userId": "string", "enterpriseId": "string", "organizationId": "string", "rejectLabels": [ "string" ] }