curl --request GET \
--url https://api.baselayer.com/issuance/identities/businesses \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/businesses"
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', 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",
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"
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")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/businesses")
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[
{
"business_ref": "<string>",
"legal_name": "<string>",
"incorporation_state": "AL",
"kyb_outcome": "VERIFIED",
"verified_people_count": 123,
"under_review_people_count": 123,
"rejected_people_count": 123,
"last_activity_at": "2023-11-07T05:31:56Z",
"linked_people_count": 123,
"not_verified_reason": "VERIFICATION_INCOMPLETE",
"last_verified_at": "2023-11-07T05:31:56Z"
}
]{
"type": "validation_failed",
"code": 7112,
"message": "The request is invalid.",
"metadata": {}
}List the businesses your organization has verified
Lists every business your organization holds a bus_ reference for, most recent activity first by default: its registered name and state, what your latest evaluation concluded, how its operators stand, and when it last saw activity. Operator counts are reported per link status rather than collapsed into one verdict — a business can have settled operators and one awaiting review at the same time. Search by reference, EIN, or name.
curl --request GET \
--url https://api.baselayer.com/issuance/identities/businesses \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/issuance/identities/businesses"
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', 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",
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"
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")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/issuance/identities/businesses")
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[
{
"business_ref": "<string>",
"legal_name": "<string>",
"incorporation_state": "AL",
"kyb_outcome": "VERIFIED",
"verified_people_count": 123,
"under_review_people_count": 123,
"rejected_people_count": 123,
"last_activity_at": "2023-11-07T05:31:56Z",
"linked_people_count": 123,
"not_verified_reason": "VERIFICATION_INCOMPLETE",
"last_verified_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.
last_activity, name (legal name, ignoring case) or created_at (when your organization first held its reference); ties break on created_at, then the reference's id. Defaults to last_activity desc.
What the businesses list sorts by.
last_activity, name, created_at asc or desc, for every key of the sort. Defaults to the field's own: last_activity desc, name asc, created_at desc.
asc, desc Only businesses whose latest evaluation by your organization reached this outcome. What the organization's latest confirmation concluded about a business.
Two values only: a listed business always has a KYB match behind its
reference, so a check that never finished (stored NULL) is NOT_VERIFIED
with BusinessNotVerifiedReason.VerificationIncomplete, not a third
outcome.
VERIFIED, NOT_VERIFIED Only businesses with at least one covered operator link in this status. Your organization's status for the link between an individual and a business they operate.
VERIFIED is earned by the full evidence recipe (TIN provided + IRS-matched + KYB-verified) on one of your own sessions, or decided by your organization; UNDER_REVIEW is every automatic shortfall; REJECTED is your organization's refusal, which stands until you decide again. Another organization's evidence or decision never changes it.
VERIFIED, UNDER_REVIEW, REJECTED A bus_ reference, or free text matched against the registered business name; nine digits also match as an exact EIN.
200Filter records created on or after this date (format: YYYY-MM-DD).
Filter records created on or before this date (format: YYYY-MM-DD).
IANA timezone identifier used to interpret start_date and end_date (defaults to UTC).
"UTC"
"America/Los_Angeles"
"Europe/London"
Response
Paginated businesses in the requested order, scoped to the calling organization.
This organization's pairwise reference to the business.
The business's registered legal name.
State of incorporation.
AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, PR, VI, AE, AA, AP, GU, AS What this organization's most recent confirmation concluded.
VERIFIED, NOT_VERIFIED Covered operator links in VERIFIED — people who can mint.
Covered operator links in UNDER_REVIEW — business mints for these people are refused until a reviewer decides.
Covered operator links a reviewer rejected.
The latest of: an operator link confirmed or decided, and an agent credential issued or revoked for the business, by this organization. Starts when the business entered the directory.
Operator links this organization covers, in any status.
VERIFICATION_INCOMPLETE when the check never finished; null when verified or when it ran and failed.
VERIFICATION_INCOMPLETE When this organization last covered the business with an evaluation of its own.