curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/kyb-records \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/kyb-records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-sandbox.finogates.com/v1/platform/kyb-records', 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-sandbox.finogates.com/v1/platform/kyb-records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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-sandbox.finogates.com/v1/platform/kyb-records"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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-sandbox.finogates.com/v1/platform/kyb-records")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/kyb-records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status_code": 200,
"data": [
{
"id": "d2e3f4a5-b6c7-8901-2345-67890abcdef0",
"status": "approved",
"approved_at": "2025-06-11T09:00:00.000Z",
"created_at": "2025-06-10T18:12:00.000Z",
"updated_at": "2025-06-11T09:00:00.000Z",
"user_id": "b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4",
"subject_email": "ops@lovelace.example.com",
"subject_name": "Lovelace Analytics LLC",
"business_legal_name": "Lovelace Analytics LLC",
"business_ein": "12-3456789",
"business_type": "llc",
"dba": "Lovelace Analytics",
"website": "https://lovelace.example.com",
"registration_number": "C1234567",
"formation_date": "2021-04-12",
"mcc": "7372",
"business_description": "Data analytics software",
"business_email": "ops@lovelace.example.com",
"business_phone": "+14155550199",
"phone_country_code": "+1",
"address": "500 Terry Francois Blvd",
"city": "San Francisco",
"state": "CA",
"country": "US",
"zip": "94158",
"contact_first_name": "Ada",
"contact_last_name": "Lovelace",
"contact_email": "ada@lovelace.example.com",
"business_documents": [],
"ownership": [
{
"name": "Ada Lovelace",
"role": "founder",
"ownership_pct": 100
}
]
}
],
"row_count": 1,
"limit": 50,
"current_page": 1,
"total_page_number": 1,
"query_generated_time": 1712847600000
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}List KYB Records
Get the business verification (KYB) records for every user on your platform.
curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/kyb-records \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/kyb-records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-sandbox.finogates.com/v1/platform/kyb-records', 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-sandbox.finogates.com/v1/platform/kyb-records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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-sandbox.finogates.com/v1/platform/kyb-records"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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-sandbox.finogates.com/v1/platform/kyb-records")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/kyb-records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status_code": 200,
"data": [
{
"id": "d2e3f4a5-b6c7-8901-2345-67890abcdef0",
"status": "approved",
"approved_at": "2025-06-11T09:00:00.000Z",
"created_at": "2025-06-10T18:12:00.000Z",
"updated_at": "2025-06-11T09:00:00.000Z",
"user_id": "b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4",
"subject_email": "ops@lovelace.example.com",
"subject_name": "Lovelace Analytics LLC",
"business_legal_name": "Lovelace Analytics LLC",
"business_ein": "12-3456789",
"business_type": "llc",
"dba": "Lovelace Analytics",
"website": "https://lovelace.example.com",
"registration_number": "C1234567",
"formation_date": "2021-04-12",
"mcc": "7372",
"business_description": "Data analytics software",
"business_email": "ops@lovelace.example.com",
"business_phone": "+14155550199",
"phone_country_code": "+1",
"address": "500 Terry Francois Blvd",
"city": "San Francisco",
"state": "CA",
"country": "US",
"zip": "94158",
"contact_first_name": "Ada",
"contact_last_name": "Lovelace",
"contact_email": "ada@lovelace.example.com",
"business_documents": [],
"ownership": [
{
"name": "Ada Lovelace",
"role": "founder",
"ownership_pct": 100
}
]
}
],
"row_count": 1,
"limit": 50,
"current_page": 1,
"total_page_number": 1,
"query_generated_time": 1712847600000
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
Show only records with this status — for example pending, in_review, approved, or rejected.
How many records to return per page (1 to 200).
1 <= x <= 200How many records to skip before this page starts.
x >= 0Response
A page of business (KYB) records.
HTTP status code for the response.
Payload or error details.
Show child attributes
Show child attributes
UTC timestamp (milliseconds since epoch) when response was generated.
Total rows matching the request filters (not just this page).
x >= 0Page size used for this response. Null for cursor-paginated endpoints.
x >= 11-indexed page number for this response. Null for cursor-paginated endpoints.
x >= 1Total number of pages given the current limit. Null for cursor-paginated endpoints.
x >= 0Cursor for the next page, if available.

