Get Verification Status

curl --request GET \
  --url https://api.urtentic.com/api/v1/verifications/{verificationId}/status

const options = {method: 'GET'};

fetch('https://api.urtentic.com/api/v1/verifications/{verificationId}/status', 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.urtentic.com/api/v1/verifications/{verificationId}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.urtentic.com/api/v1/verifications/{verificationId}/status"

	req, _ := http.NewRequest("GET", 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.urtentic.com/api/v1/verifications/{verificationId}/status")

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

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

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

{
  "verificationId": "85c94e71-6e3f-4a19-b15c-781d8a876542",
  "status": "COMPLETED",
  "result": "APPROVED",
  "completedAt": "2023-06-15T15:30:00Z",
  "steps": [
    {
      "processType": "DOCUMENT_VERIFICATION",
      "status": "COMPLETED",
      "result": "APPROVED",
      "completedAt": "2023-06-15T15:25:00Z"
    },
    {
      "processType": "LIVENESS",
      "status": "COMPLETED",
      "result": "APPROVED",
      "completedAt": "2023-06-15T15:28:00Z"
    }
  ],
  "missingInputs": []
}

Verification

Get Verification Status

Retrieves the current status of a verification process. This endpoint allows you to check the progress and results of an ongoing or completed verification.

Use Cases

Polling for verification completion
Checking verification results
Determining if additional inputs are needed
Retrieving verification outcome details

Notes

This endpoint requires an API key with verification read permissions
Status updates may take time to process depending on the verification type
For real-time updates, configure webhooks instead of polling this endpoint

GET

verifications

{verificationId}

status

Get Verification Status

curl --request GET \
  --url https://api.urtentic.com/api/v1/verifications/{verificationId}/status

const options = {method: 'GET'};

fetch('https://api.urtentic.com/api/v1/verifications/{verificationId}/status', 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.urtentic.com/api/v1/verifications/{verificationId}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.urtentic.com/api/v1/verifications/{verificationId}/status"

	req, _ := http.NewRequest("GET", 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.urtentic.com/api/v1/verifications/{verificationId}/status")

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

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

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

{
  "verificationId": "85c94e71-6e3f-4a19-b15c-781d8a876542",
  "status": "COMPLETED",
  "result": "APPROVED",
  "completedAt": "2023-06-15T15:30:00Z",
  "steps": [
    {
      "processType": "DOCUMENT_VERIFICATION",
      "status": "COMPLETED",
      "result": "APPROVED",
      "completedAt": "2023-06-15T15:25:00Z"
    },
    {
      "processType": "LIVENESS",
      "status": "COMPLETED",
      "result": "APPROVED",
      "completedAt": "2023-06-15T15:28:00Z"
    }
  ],
  "missingInputs": []
}

Path Parameters

verificationId

string<uuid>

required

Unique identifier of the verification.

Response

Verification status information

verificationId

string<uuid>

Unique identifier for the verification

Example:

"85c94e71-6e3f-4a19-b15c-781d8a876542"

status

string

Current status of the verification:

PENDING: Verification has been created but not started
INITIATED: Verification has started but inputs are pending
PROCESSING: Inputs received and verification is in progress
COMPLETED: Verification completed successfully
FAILED: Verification failed
ABANDONED: Verification was abandoned by the user
EXPIRED: Verification session expired

Example:

"COMPLETED"

result

string

Result of the verification (if completed):

APPROVED: Verification passed all checks
DECLINED: Verification failed one or more checks
MANUAL_REVIEW: Verification requires manual review

Example:

"APPROVED"

completedAt

string<date-time>

When the verification was completed

Example:

"2023-06-15T15:30:00Z"

steps

object[]

Status of individual verification steps

Show child attributes

missingInputs

string[]

List of inputs that are still required

Example:

[]

Overview

Verification

Workflows

Webhooks

Get Verification Status

Use Cases

Notes

Path Parameters

Response