Get Face Match Verification
curl --request GET \
--url http://api.gu1.ai/api/kyc/face-match/verifications/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/api/kyc/face-match/verifications/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/api/kyc/face-match/verifications/{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 => "http://api.gu1.ai/api/kyc/face-match/verifications/{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 := "http://api.gu1.ai/api/kyc/face-match/verifications/{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("http://api.gu1.ai/api/kyc/face-match/verifications/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/api/kyc/face-match/verifications/{id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyFace Match
Get Face Match Verification
Retrieve a single Face Match audit record by ID β in the gu1 KYC API for identity verification flows, with examples for get face match verification use cases.
GET
/
api
/
kyc
/
face-match
/
verifications
/
{id}
Get Face Match Verification
curl --request GET \
--url http://api.gu1.ai/api/kyc/face-match/verifications/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/api/kyc/face-match/verifications/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/api/kyc/face-match/verifications/{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 => "http://api.gu1.ai/api/kyc/face-match/verifications/{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 := "http://api.gu1.ai/api/kyc/face-match/verifications/{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("http://api.gu1.ai/api/kyc/face-match/verifications/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/api/kyc/face-match/verifications/{id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyOverview
Returns one Face Match verification by itsid (the same UUID returned as verificationId in the POST Face Match response or in the list endpoint). Use it to fetch full details of a past verification for audit, support, or detail views.
Key points:
- Scoped to your organization; returns 404 if the ID does not exist or belongs to another org.
- Same fields as each item in the list:
id,entityId,status,match,score,threshold,createdAt, and optional image paths.
To download stored document and selfie bytes, use Get Face Match images (
/document-image and /selfie-image).Request
Endpoint
GET https://api.gu1.ai/api/kyc/face-match/verifications/:id
Path Parameters
string
required
UUID of the Face Match verification (same as
verificationId from POST or list).Headers
{
"Authorization": "Bearer YOUR_API_KEY"
}
X-Organization-Id if your account is scoped by organization.
Response
Success (200 OK)
Single verification object:| Field | Type | Description |
|---|---|---|
id | string | Verification UUID. |
organizationId | string | Organization that owns the record. |
entityId | string | null | Person entity ID if provided in the request. |
status | string | approved | declined | in_review | failed. |
match | boolean | Whether faces were considered a match. |
score | number | null | Similarity score 0β100 (null when status is failed). |
requestId | string | null | Internal request ID (support). |
vendorData | string | null | Client reference from the request. |
errorMessage | string | null | Error message when status is failed. |
triggeredByUserId | string | null | User who called the API. |
createdAt | string | ISO timestamp. |
documentStoragePath | string | null | Storage path for document image (audit). |
selfieStoragePath | string | null | Storage path for selfie image (audit). |
storageProvider | string | null | s3 or local. |
threshold | number | null | Score threshold used for this verification (from org settings at the time). |
Error Responses
| Code | HTTP | Description |
|---|---|---|
NOT_FOUND | 404 | Verification ID does not exist or belongs to another organization. |
UNAUTHORIZED | 401 | Missing or invalid API key or organization context. |
Example
const id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
const response = await fetch(`https://api.gu1.ai/api/kyc/face-match/verifications/${id}`, {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
});
const verification = await response.json();
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.gu1.ai/api/kyc/face-match/verifications/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Next Steps
Face Match (POST)
Verify document + selfie in one call
List Validations
List KYC validations by entity
Was this page helpful?