Face Search – Search
Searches an input face image against all enrolled identities in the AI-ForensiX face search index.
The Face Search API compares an input face image against all previously enrolled face embeddings in the search index.
It returns the most similar matches with similarity scores, enabling quick identification or recognition workflows.
Endpoint
POST /v1/facesearch/searchRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
file | binary | Yes | Face image to search in the index. |
Example Request (cURL)
curl -X POST "https://forensiz.ai/search" \
-H "x-api-key: YOUR_API_KEY" \
-F file=@"/path/face.jpg"Response Status Codes
| Status Code | Meaning |
|---|---|
| 200 OK | Search completed successfully. |
| 400 Bad Request | Invalid request or missing file. |
| 401 Unauthorized | Invalid or missing API key. |
| 403 Forbidden | Service access not permitted. |
| 404 Not Found | Endpoint does not exist. |
| 415 Unsupported Media Type | Unsupported file format. |
| 500 Internal Server Error | Unexpected server error. |