---
title: "Get Image Matches"
method: GET
path: "/api/v1/identities/{identity_id}/image-matches"
tags: ["identities"]
---

# Get Image Matches

`GET /api/v1/identities/{identity_id}/image-matches`

## Request

- Base URL: `https://api.withverifa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.withverifa.com/api/v1/identities/{identity_id}/image-matches`
- Auth: none declared

Find cross-session face similarity matches for an identity.

Compares all face embeddings belonging to the identity against other
embeddings in the organization, returning matches above the similarity
threshold sorted by score descending.

Optionally filter by source_type to compare only selfie or document_front
embeddings.

## Path parameters

- `identity_id` string, required

## Query parameters

- `threshold` number
- `limit` integer
- `offset` integer
- `source_type` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/withverifa/apis/verifa.md) · [All operations](https://skmtc.dev/withverifa/apis/verifa/llms.txt) · [OpenAPI document](https://skmtc.dev/withverifa/apis/verifa/revisions/7288c82c9e33?raw)