> ## Documentation Index
> Fetch the complete documentation index at: https://venator-06aff335.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Fingerprint Match (One to One)
Verify whether two fingerprint samples belong to the same individual. The service performs biometric fingerprint comparison and returns a similarity score indicating the confidence of the match.
POST
/api/gw/services/fingerprint\_match
***
### Authorizations
API key used to authenticate the request.
***
### Body
Base64 encoded first fingerprint image sample.
Base64 encoded second fingerprint image sample to compare.
File name of the first fingerprint image.
File name of the second fingerprint image.
***
### Response
Indicates whether the request was processed successfully.
Unique identifier for the API request.
Identifier used for tracing the request across systems.
Contains fingerprint comparison results.
Indicates whether both fingerprint samples belong to the same individual.
Similarity score between both fingerprint samples (0 to 1).
Confidence score of the fingerprint verification result (0 to 1).
Contains error details if the request fails; otherwise null.
Time taken to process the request in milliseconds.
Timestamp when the request was processed (ISO 8601 format).
Error message returned when fingerprint matching fails.
***
```bash Curl theme={null}
curl -X POST "https://dev-idf-gw.cognetlabs.org/api/gw/services/fingerprint_match" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"fingerprintImage1Base64": "",
"fingerprintImage2Base64": "",
"fingerprintImage1FileName": "fingerprint_1.png",
"fingerprintImage2FileName": "fingerprint_2.png"
}'
```
```python Python theme={null}
import requests
url = "https://dev-idf-gw.cognetlabs.org/api/gw/services/fingerprint_match"
headers = {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
payload = {
"fingerprintImage1Base64": "",
"fingerprintImage2Base64": "",
"fingerprintImage1FileName": "fingerprint_1.png",
"fingerprintImage2FileName": "fingerprint_2.png"
}
res = requests.post(url, json=payload, headers=headers)
print(res.json())
```
```javascript JavaScript theme={null}
fetch("https://dev-idf-gw.cognetlabs.org/api/gw/services/fingerprint_match", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
},
body: JSON.stringify({
fingerprintImage1Base64: "",
fingerprintImage2Base64: "",
fingerprintImage1FileName: "fingerprint_1.png",
fingerprintImage2FileName: "fingerprint_2.png"
})
})
.then(res => res.json())
.then(console.log);
```
```php PHP theme={null}
"",
"fingerprintImage2Base64" => "",
"fingerprintImage1FileName" => "fingerprint_1.png",
"fingerprintImage2FileName" => "fingerprint_2.png"
];
$options = [
"http" => [
"header" => "Content-Type: application/json\r\nx-api-key: YOUR_API_KEY",
"method" => "POST",
"content" => json_encode($data),
],
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>
```
```go Go theme={null}
package main
import (
"bytes"
"net/http"
)
func main() {
jsonData := []byte(`{
"fingerprintImage1Base64":"",
"fingerprintImage2Base64":"",
"fingerprintImage1FileName":"fingerprint_1.png",
"fingerprintImage2FileName":"fingerprint_2.png"
}`)
req, _ := http.NewRequest(
"POST",
"https://dev-idf-gw.cognetlabs.org/api/gw/services/fingerprint_match",
bytes.NewBuffer(jsonData),
)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
client.Do(req)
}
```
```java Java theme={null}
import okhttp3.*;
public class Main {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
String json = "{\"fingerprintImage1Base64\":\"\", \"fingerprintImage2Base64\":\"\", \"fingerprintImage1FileName\":\"fingerprint_1.png\", \"fingerprintImage2FileName\":\"fingerprint_2.png\" }";
RequestBody body = RequestBody.create(
json,
MediaType.parse("application/json")
);
Request request = new Request.Builder()
.url("https://dev-idf-gw.cognetlabs.org/api/gw/services/fingerprint_match")
.addHeader("x-api-key", "YOUR_API_KEY")
.post(body)
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
}
}
```
```ruby Ruby theme={null}
require 'net/http'
require 'uri'
require 'json'
uri = URI.parse("https://dev-idf-gw.cognetlabs.org/api/gw/services/fingerprint_match")
header = {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
}
payload = {
fingerprintImage1Base64: "",
fingerprintImage2Base64: "",
fingerprintImage1FileName: "fingerprint_1.png",
fingerprintImage2FileName: "fingerprint_2.png"
}
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri.request_uri, header)
request.body = payload.to_json
response = http.request(request)
puts response.body
```
```json 200 theme={null}
{
"success": true,
"requestId": "fp123456",
"correlationId": "58664e8f17d1452ea3b171e7a90e09bf",
"data": {
"match": true,
"similarityScore": 0.94,
"confidenceScore": 0.97
},
"error": null,
"durationMs": 350,
"processedAt": "2026-04-29T13:59:35.9472104Z"
}
```
```json 400 theme={null}
{
"error": "FingerprintImage1Base64 is required"
}
```