curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/users/verification/{user_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/users/verification/{user_id}"
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/users/verification/{user_id}', 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/users/verification/{user_id}",
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/users/verification/{user_id}"
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/users/verification/{user_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/users/verification/{user_id}")
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": {
"user_id": "b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4",
"first_name": "Ada",
"last_name": "Lovelace",
"dob": "1990-05-12",
"phone_no": "+14155550123",
"address": "500 Terry Francois Blvd",
"city": "San Francisco",
"state": "CA",
"zip": "94158",
"country": "US",
"id_type": "passport",
"selfie": "https://files.finogates.com/kyc/selfie.jpg?expires=1712851200&signature=abc123",
"id_front_img": "https://files.finogates.com/kyc/id-front.jpg?expires=1712851200&signature=def456",
"id_back_img": "https://files.finogates.com/kyc/id-back.jpg?expires=1712851200&signature=ghi789",
"kyc_status": "approved",
"email": "ada@lovelace.example.com",
"inquiry_id": "inq_9aZ8bY7cX6"
},
"query_generated_time": 1712847600000
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Get User Verification
Get one user’s identity verification (KYC) details.
The response combines the latest identity check (status, decline reason, contact email, verification inquiry id) with the personal information captured during verification (name, date of birth, address, ID document images). Image fields come back as short-lived download links.
If the user has not started identity verification yet, the response is
still a success and collapses to user_id, kyc_status of
not_applied, and a short message saying so — there is no body full
of empty fields. That is a normal, expected state, not an error.
curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/users/verification/{user_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/users/verification/{user_id}"
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/users/verification/{user_id}', 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/users/verification/{user_id}",
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/users/verification/{user_id}"
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/users/verification/{user_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/users/verification/{user_id}")
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": {
"user_id": "b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4",
"first_name": "Ada",
"last_name": "Lovelace",
"dob": "1990-05-12",
"phone_no": "+14155550123",
"address": "500 Terry Francois Blvd",
"city": "San Francisco",
"state": "CA",
"zip": "94158",
"country": "US",
"id_type": "passport",
"selfie": "https://files.finogates.com/kyc/selfie.jpg?expires=1712851200&signature=abc123",
"id_front_img": "https://files.finogates.com/kyc/id-front.jpg?expires=1712851200&signature=def456",
"id_back_img": "https://files.finogates.com/kyc/id-back.jpg?expires=1712851200&signature=ghi789",
"kyc_status": "approved",
"email": "ada@lovelace.example.com",
"inquiry_id": "inq_9aZ8bY7cX6"
},
"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.
Path Parameters
Response
The user's identity (KYC) details. Empty fields are omitted; image fields are short-lived download links.

