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

x-api-key · string · required

API key used to authenticate the request.

---

Body

fingerprintImage1Base64 · string · required

Base64 encoded first fingerprint image sample.

fingerprintImage2Base64 · string · required

Base64 encoded second fingerprint image sample to compare.

fingerprintImage1FileName · string

File name of the first fingerprint image.

fingerprintImage2FileName · string

File name of the second fingerprint image.

---

Response

200

success · boolean

Indicates whether the request was processed successfully.

requestId · string

Unique identifier for the API request.

correlationId · string

Identifier used for tracing the request across systems.

data · object

Contains fingerprint comparison results.

data.match · boolean

Indicates whether both fingerprint samples belong to the same individual.

data.similarityScore · number

Similarity score between both fingerprint samples (0 to 1).

data.confidenceScore · number

Confidence score of the fingerprint verification result (0 to 1).

error · object | null

Contains error details if the request fails; otherwise null.

durationMs · number

Time taken to process the request in milliseconds.

processedAt · string

Timestamp when the request was processed (ISO 8601 format).

400

error · string

Error message returned when fingerprint matching fails.

---

Curl

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": "<base64-fingerprint-1>",
  "fingerprintImage2Base64": "<base64-fingerprint-2>",
  "fingerprintImage1FileName": "fingerprint_1.png",
  "fingerprintImage2FileName": "fingerprint_2.png"
}'

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": "<base64-fingerprint-1>",
    "fingerprintImage2Base64": "<base64-fingerprint-2>",
    "fingerprintImage1FileName": "fingerprint_1.png",
    "fingerprintImage2FileName": "fingerprint_2.png"
}

res = requests.post(url, json=payload, headers=headers)

print(res.json())

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: "<base64-fingerprint-1>",
    fingerprintImage2Base64: "<base64-fingerprint-2>",
    fingerprintImage1FileName: "fingerprint_1.png",
    fingerprintImage2FileName: "fingerprint_2.png"
  })
})
.then(res => res.json())
.then(console.log);

<?php
$url = "https://dev-idf-gw.cognetlabs.org/api/gw/services/fingerprint_match";

$data = [
  "fingerprintImage1Base64" => "<base64-fingerprint-1>",
  "fingerprintImage2Base64" => "<base64-fingerprint-2>",
  "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;
?>

package main

import (
	"bytes"
	"net/http"
)

func main() {

	jsonData := []byte(`{
		"fingerprintImage1Base64":"<base64-fingerprint-1>",
		"fingerprintImage2Base64":"<base64-fingerprint-2>",
		"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)
}

import okhttp3.*;

public class Main {
    public static void main(String[] args) throws Exception {

        OkHttpClient client = new OkHttpClient();

        String json = "{\"fingerprintImage1Base64\":\"<base64-fingerprint-1>\", \"fingerprintImage2Base64\":\"<base64-fingerprint-2>\", \"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());
    }
}

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: "<base64-fingerprint-1>",
  fingerprintImage2Base64: "<base64-fingerprint-2>",
  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

200

{
  "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"
}

{
  "error": "FingerprintImage1Base64 is required"
}