curl --request GET \
--url https://api.baselayer.com/issuance/identities/verifications/{verification_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/verifications/{verification_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.baselayer.com/issuance/identities/verifications/{verification_id}', 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.baselayer.com/issuance/identities/verifications/{verification_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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.baselayer.com/issuance/identities/verifications/{verification_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.baselayer.com/issuance/identities/verifications/{verification_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/verifications/{verification_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "INDIVIDUAL",
"state": "PENDING",
"environment": "sandbox",
"created_at": "2023-11-07T05:31:56Z",
"automated_verdict": "APPROVED",
"verdict": "APPROVED",
"terminal_reason": {
"state": "FAILED",
"message": "<string>"
},
"individual_ref": "<string>",
"business_ref": "<string>",
"business_operator_link_status": "VERIFIED",
"reference_id": "<string>",
"idempotency_key": "<string>",
"completed_at": "2023-11-07T05:31:56Z"
}{
"type": "resource_not_found",
"code": 1,
"message": "Could not locate the resource for the given URI.",
"metadata": {}
}{
"type": "validation_failed",
"code": 7112,
"message": "The request is invalid.",
"metadata": {}
}Get a direct verification
Returns a verification: its state, verdicts, terminal_reason, and the pairwise references it issued.
This is direct verification: you send an identity you collected. For a hosted enrollment session, where the applicant completes your published journey on Baselayer’s page, use POST /onboarding/sessions.
curl --request GET \
--url https://api.baselayer.com/issuance/identities/verifications/{verification_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/verifications/{verification_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.baselayer.com/issuance/identities/verifications/{verification_id}', 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.baselayer.com/issuance/identities/verifications/{verification_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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.baselayer.com/issuance/identities/verifications/{verification_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.baselayer.com/issuance/identities/verifications/{verification_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/verifications/{verification_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "INDIVIDUAL",
"state": "PENDING",
"environment": "sandbox",
"created_at": "2023-11-07T05:31:56Z",
"automated_verdict": "APPROVED",
"verdict": "APPROVED",
"terminal_reason": {
"state": "FAILED",
"message": "<string>"
},
"individual_ref": "<string>",
"business_ref": "<string>",
"business_operator_link_status": "VERIFIED",
"reference_id": "<string>",
"idempotency_key": "<string>",
"completed_at": "2023-11-07T05:31:56Z"
}{
"type": "resource_not_found",
"code": 1,
"message": "Could not locate the resource for the given URI.",
"metadata": {}
}{
"type": "validation_failed",
"code": 7112,
"message": "The request is invalid.",
"metadata": {}
}Authorizations
Path Parameters
Response
Response
A verification of an individual, or of an individual and the business they operate, submitted directly.
The body of every /issuance/identities/verifications route and of the
Verification.* webhooks.
Unique id of the verification.
Whether a business is verified too.
INDIVIDUAL, BUSINESS Lifecycle state of the verification workflow.
PENDING, EXECUTING, WAITING, COMPLETED, FAILED, EXPIRED The environment the verification ran in.
sandbox, production When the verification was created.
What the checks concluded, APPROVED or UNDER_REVIEW; null until the verification completes.
APPROVED, UNDER_REVIEW, REJECTED The effective verdict: your reviewer's decision when one was made, otherwise automated_verdict.
APPROVED, UNDER_REVIEW, REJECTED Typed state and detail when the workflow ended in FAILED; null otherwise.
Show child attributes
Show child attributes
Your pairwise reference to the verified individual, stable across re-verification; set once the verification completes and is approved.
Your pairwise reference to the verified business, when the verification covered one.
Status of the individual-operates-business link as of this verification.
VERIFIED, UNDER_REVIEW, REJECTED Caller-supplied correlation id.
The Idempotency-Key the verification was created with.
When the verification reached a terminal status.