curl --request GET \
--url https://api.baselayer.com/issuance/identities/verifications \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/verifications"
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', 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",
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"
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")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/verifications")
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": "validation_failed",
"code": 7112,
"message": "The request is invalid.",
"metadata": {}
}List direct verifications
Lists the verifications your application started through POST /issuance/identities/verifications, newest first by default. Filter by reference_id to find the verifications you started for one of your records.
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 \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/verifications"
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', 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",
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"
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")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/verifications")
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": "validation_failed",
"code": 7112,
"message": "The request is invalid.",
"metadata": {}
}Authorizations
Query Parameters
Maximum number of records to return in a single page. Must be between 1 and 1000.
1 <= x <= 1000Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.
x >= 0Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset.
created_at (when it started) or updated_at (when it last changed); ties break on created_at, then the verification's id. Defaults to created_at desc.
What the verifications list sorts by.
created_at, updated_at asc or desc, for every key of the sort. Defaults to the field's own: created_at desc, updated_at desc.
asc, desc Only verifications started with this reference_id.
128Only verifications in this state.
A verification's lifecycle as a customer reads it: the workflow's
states, with an internal stop reported as FAILED.
PENDING, EXECUTING, WAITING, COMPLETED, FAILED, EXPIRED Only INDIVIDUAL or only BUSINESS verifications.
What a verification verifies: an INDIVIDUAL alone, or an
individual together with the BUSINESS they operate.
INDIVIDUAL, BUSINESS Response
Paginated verifications in the requested order.
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.