---
title: "POST /search/template/{tenantId}"
method: POST
path: "/search/template/{tenantId}"
tags: ["Search"]
---

# POST /search/template/{tenantId}

`POST /search/template/{tenantId}`

Busca un patrón biométrico, extraído de un template raw, entre los especímenes (rostros) almacenados en la base de datos, bajo el mismo tenantId.

## Path parameters

- `tenantId` string, required — Un identificador que permite agrupar distintas imágenes o patrones biométricos en un espacio común.

## Request body

- SearchTemplateBody — Body para la solicitud POST de búsqueda por template
  - `facialTemplateRaw` string — Un token extendido que contiene patrones biométricos y metadatos. Se recomienda su almacenamiento en bases de datos por ser persistente. Puede actualizarse automáticamente en caso de cambios en la tecnología de extracción. Está codificado en base64 RFC4648.
  - `options` SearchOptions — Opciones al buscar patrones biométricos.
    - `maxCandidates` integer — El número máximo de candidatos que se desean en la respuesta.
    - `minSimilariry` number — La similitud mínima requerida para que un candidato se incluya en la respuesta.

## Response `200`

El resultado de la búsqueda, una lista de ids de template.

- SearchItem[] — Una lista de especímenes (rostros) encontrados en la base de datos
  - `galleryIndex` integer — La posición que ocupa un elemento en la galería.
  - `similarity` number — Similitud resultante de la comparación.
  - `templateId` string — Un identificador de un espécimen (rostro) en la base de datos.

## Other responses

- `400` — Llegan parámetros incorrectos en la solicitud.
- `500` — Se ha producido un error en la llamada al backend de Voice-SDK.

---

[API](https://skmtc.net/facephi/apis/selphid-sdk-rest-api.md) · [All operations](https://skmtc.net/facephi/apis/selphid-sdk-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/facephi/selphid-sdk-rest-api/revisions/acc985032f98/schema)