curl --request GET \
--url https://api.baselayer.com/issuance/identities/individuals/{individual_ref} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/individuals/{individual_ref}"
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/individuals/{individual_ref}', 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/individuals/{individual_ref}",
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/individuals/{individual_ref}"
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/individuals/{individual_ref}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/individuals/{individual_ref}")
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{
"individual_ref": "<string>",
"verification_state": "CURRENT",
"credentials": {
"issued_30d": 123,
"active": 123,
"revoked_30d": 123
},
"display_name": "<string>",
"verified_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"active_keys": [
"<string>"
],
"available_disclosure_paths": [
"<string>"
],
"verification_level": 123,
"possession_verified_at": "2023-11-07T05:31:56Z",
"latest_reverification": {
"verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "PENDING",
"created_at": "2023-11-07T05:31:56Z",
"verdict": "APPROVED",
"reference_id": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"terminal_reason": {
"state": "FAILED",
"message": "<string>"
},
"journey_name": "<string>",
"decided_by": {
"kind": "USER",
"label": "<string>"
}
},
"businesses": [
{
"status": "VERIFIED",
"created_at": "2023-11-07T05:31:56Z",
"business_ref": "<string>",
"legal_name": "<string>",
"review_flagged_at": "2023-11-07T05:31:56Z",
"decided_at": "2023-11-07T05:31:56Z",
"decided_by": {
"kind": "USER",
"label": "<string>"
},
"decision_reason": "<string>",
"source_verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"submissions": [
{
"verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "PENDING",
"created_at": "2023-11-07T05:31:56Z",
"verdict": "APPROVED",
"reference_id": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"terminal_reason": {
"state": "FAILED",
"message": "<string>"
},
"journey_name": "<string>",
"decided_by": {
"kind": "USER",
"label": "<string>"
}
}
],
"active_credentials": [
{
"credential_id": "<string>",
"level": "L2",
"audience": "<string>",
"preset": "consumer_ecommerce",
"issued_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
}
],
"verification_history": [
{
"verified_at": "2023-11-07T05:31:56Z",
"superseded_at": "2023-11-07T05:31:56Z",
"expires_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": {}
}Look up a verified identity by pairwise reference
Returns the verification state, verified-attribute keys, verification level, and covered business links for a individual_ref issued to your organization. References issued to other organizations and unknown references are indistinguishable 404s.
curl --request GET \
--url https://api.baselayer.com/issuance/identities/individuals/{individual_ref} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/individuals/{individual_ref}"
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/individuals/{individual_ref}', 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/individuals/{individual_ref}",
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/individuals/{individual_ref}"
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/individuals/{individual_ref}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/individuals/{individual_ref}")
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{
"individual_ref": "<string>",
"verification_state": "CURRENT",
"credentials": {
"issued_30d": 123,
"active": 123,
"revoked_30d": 123
},
"display_name": "<string>",
"verified_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"active_keys": [
"<string>"
],
"available_disclosure_paths": [
"<string>"
],
"verification_level": 123,
"possession_verified_at": "2023-11-07T05:31:56Z",
"latest_reverification": {
"verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "PENDING",
"created_at": "2023-11-07T05:31:56Z",
"verdict": "APPROVED",
"reference_id": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"terminal_reason": {
"state": "FAILED",
"message": "<string>"
},
"journey_name": "<string>",
"decided_by": {
"kind": "USER",
"label": "<string>"
}
},
"businesses": [
{
"status": "VERIFIED",
"created_at": "2023-11-07T05:31:56Z",
"business_ref": "<string>",
"legal_name": "<string>",
"review_flagged_at": "2023-11-07T05:31:56Z",
"decided_at": "2023-11-07T05:31:56Z",
"decided_by": {
"kind": "USER",
"label": "<string>"
},
"decision_reason": "<string>",
"source_verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"submissions": [
{
"verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "PENDING",
"created_at": "2023-11-07T05:31:56Z",
"verdict": "APPROVED",
"reference_id": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"terminal_reason": {
"state": "FAILED",
"message": "<string>"
},
"journey_name": "<string>",
"decided_by": {
"kind": "USER",
"label": "<string>"
}
}
],
"active_credentials": [
{
"credential_id": "<string>",
"level": "L2",
"audience": "<string>",
"preset": "consumer_ecommerce",
"issued_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
}
],
"verification_history": [
{
"verified_at": "2023-11-07T05:31:56Z",
"superseded_at": "2023-11-07T05:31:56Z",
"expires_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
Body for GET /issuance/identities/individuals/{individual_ref}.
Strictly scoped to the calling organization: only links it covered with
its own sessions are listed, and no PII beyond what the organization
itself submitted is echoed — display_name repeats the verified name
the list row already returns to the same caller, nothing more.
The queried pairwise individual reference.
CURRENT, or EXPIRED (re-verify before minting). SUPERSEDED only when your organization holds no current verification of the individual, which registration never leaves.
CURRENT, EXPIRED, SUPERSEDED This organization's agent credentials for the individual, counting business credentials they acted for.
Show child attributes
Show child attributes
The verified name, as the latest snapshot recorded it — the same value the list row carries. Null when every snapshot has been superseded. Mask it in shared surfaces; the API returns what the organization itself submitted.
When the latest verification was recorded.
When the latest verification expires.
Names of the individual verification checks the identity currently holds (e.g. phone_possession, ssn_identity_match), from the token-exchange profile's key vocabulary; verification_level is derived from them. A re-verification keeps an earlier phone_possession it cannot re-run.
The subject-relative credential disclosure paths the current verification can populate, hash leaves included (e.g. hashes.ssn). Paths only, never values. A requested path missing here is skipped at mint, not refused. Empty when this organization holds no current verification.
Verification level derived from active_keys; null when the attested attributes are insufficient for any defined level.
When the individual last proved control of their phone. A re-check cannot contact the individual, so it keeps the earlier proof and this stays at that proof's date, which can be older than verified_at. Null when the latest verification attests no phone possession.
The most recent re-verification started through POST /issuance/identities/verifications with this individual_ref, whatever its outcome. Only an approved re-check replaces the current verification; a failed, rejected or under-review one leaves it unchanged.
Show child attributes
Show child attributes
Businesses this organization holds a verified or under-review operator link for, oldest first, each with its pairwise ref and link status. Rejected links are not listed.
Show child attributes
Show child attributes
This organization's approved verifications of the individual, newest first — every approved submission whose evaluation ran against the same national id. A re-check still in flight is latest_reverification and in Reviews.
Show child attributes
Show child attributes
The agent credentials counted as credentials.active, newest first.
Show child attributes
Show child attributes
Superseded verifications, newest first — when the individual was verified before and when each verification was replaced. Dates only; superseded identity fields are never re-disclosed.
Show child attributes
Show child attributes