curl --request GET \
--url https://api.baselayer.com/issuance/identities/businesses/{business_ref}/operator_links/{individual_ref} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/businesses/{business_ref}/operator_links/{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/businesses/{business_ref}/operator_links/{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/businesses/{business_ref}/operator_links/{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/businesses/{business_ref}/operator_links/{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/businesses/{business_ref}/operator_links/{individual_ref}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/businesses/{business_ref}/operator_links/{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{
"status": "VERIFIED",
"created_at": "2023-11-07T05:31:56Z",
"individual_ref": "<string>",
"business_ref": "<string>",
"business_legal_name": "<string>",
"shortfalls": [
"TIN_NOT_PROVIDED"
],
"evidence": {
"tin_provided": true,
"officer_match": "EXACT",
"evaluated_at": "2023-11-07T05:31:56Z",
"tin_matched": true,
"kyb_verified": true,
"matched_officer_name": "<string>",
"matched_officer_title": "<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",
"individual_display_name": "<string>"
}{
"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 one operator link with its evidence
One link between the individual behind individual_ref and the business behind business_ref, with the evidence a credential minted for the pair now would assert.
curl --request GET \
--url https://api.baselayer.com/issuance/identities/businesses/{business_ref}/operator_links/{individual_ref} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/businesses/{business_ref}/operator_links/{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/businesses/{business_ref}/operator_links/{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/businesses/{business_ref}/operator_links/{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/businesses/{business_ref}/operator_links/{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/businesses/{business_ref}/operator_links/{individual_ref}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/businesses/{business_ref}/operator_links/{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{
"status": "VERIFIED",
"created_at": "2023-11-07T05:31:56Z",
"individual_ref": "<string>",
"business_ref": "<string>",
"business_legal_name": "<string>",
"shortfalls": [
"TIN_NOT_PROVIDED"
],
"evidence": {
"tin_provided": true,
"officer_match": "EXACT",
"evaluated_at": "2023-11-07T05:31:56Z",
"tin_matched": true,
"kyb_verified": true,
"matched_officer_name": "<string>",
"matched_officer_title": "<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",
"individual_display_name": "<string>"
}{
"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
Response
Response
One operator link with the evidence behind it.
Your organization's current status for the link.
VERIFIED, UNDER_REVIEW, REJECTED When the link was first recorded.
Pairwise reference to the linked individual.
Pairwise reference to the linked business.
The linked business's current legal name.
What your newest evaluation of the pair fell short on, in recipe order: the reason a link is under review or flagged. Empty when it met the recipe.
Which leg of the operator-link evidence recipe a covering evaluation failed.
Reviewer-facing: a session whose evaluation reports any shortfall records an UNDER_REVIEW link, and these name what a reviewer would be overriding by verifying it anyway. An evaluation that reports none earns VERIFIED on its own.
TIN_NOT_PROVIDED, TIN_NOT_MATCHED, KYB_NOT_VERIFIED The evaluation a credential minted now would assert, which can be older than the newest when a later session only lacked a check.
Show child attributes
Show child attributes
When a later evaluation flagged this verified link for review; null when it never was.
When your organization last verified or rejected the link by hand; null while only the evidence has decided it.
Who made that decision, as stamped when they made it; null when no one has.
Show child attributes
Show child attributes
The reason recorded with that decision, if any.
The verification that established the link; null when that verification no longer exists. A direct verification reads at GET /issuance/identities/verifications/{verification_id}; a hosted one is an onboarding session and reads at GET /onboarding/sessions/{session_id}.
The individual's verified name from your organization's current verification; null when it has been superseded and not yet replaced.