> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/backend1n/technical_documentation/api_reference/search/search-image-tenantid.md).

# /search/image/{tenantId}

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

```json
{"openapi":"3.0.1","info":{"title":"API REST de Backend1n-Service","version":"4.2.0"},"servers":[{"url":"http://127.0.0.1:6982/"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"TenantId":{"type":"string","description":"Un identificador que permite agrupar distintas imágenes o patrones biométricos en un espacio común."},"SearchImageBody":{"type":"object","description":"Body para la solicitud POST de búsqueda por imagen","properties":{"image":{"$ref":"#/components/schemas/ImageBuffer"},"options":{"$ref":"#/components/schemas/SearchOptions"}},"required":["image"]},"ImageBuffer":{"type":"string","description":"Buffer de imagen en formato JPEG, PNG o BMP, codificado en base64 RFC4648."},"SearchOptions":{"type":"object","description":"Opciones al buscar patrones biométricos.","properties":{"maxCandidates":{"$ref":"#/components/schemas/MaxCandidates"},"minSimilariry":{"$ref":"#/components/schemas/MinSimilarity"}}},"MaxCandidates":{"type":"integer","default":1,"description":"El número máximo de candidatos que se desean en la respuesta."},"MinSimilarity":{"type":"number","default":0,"description":"La similitud mínima requerida para que un candidato se incluya en la respuesta."},"SearchResponse":{"type":"array","description":"Una lista de especímenes (rostros) encontrados en la base de datos","items":{"$ref":"#/components/schemas/SearchItem"}},"SearchItem":{"type":"object","description":"Espécimen encontrado en la base de datos","properties":{"galleryIndex":{"$ref":"#/components/schemas/GalleryIndex"},"similarity":{"$ref":"#/components/schemas/Similarity"},"templateId":{"$ref":"#/components/schemas/FaceId"}}},"GalleryIndex":{"type":"integer","description":"La posición que ocupa un elemento en la galería."},"Similarity":{"type":"number","default":0,"description":"Un valor entre 0 y 1 que indica el valor de similitud entre dos patrones biométricos."},"FaceId":{"type":"string","description":"Un identificador de un espécimen (rostro) en la base de datos."},"BadRequestResult":{"type":"object","description":"Resultado cuando llegan parámetros incorrectos en la solicitud.","properties":{"status":{"type":"number"},"error":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}},"TimeStamp":{"type":"string","description":"Un valor de fecha/hora en formato \"%Y-%m-%dT%H:%M:%SZ\"."},"ExceptionResult":{"type":"object","description":"Se ha producido un error en la llamada a los servicios del backend.","properties":{"status":{"type":"number"},"error":{"type":"string"},"exception":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}}}},"paths":{"/search/image/{tenantId}":{"post":{"description":"Busca un patrón biométrico, extraído de una imagen en bruto, entre los especímenes (rostros) almacenados en la base de datos, bajo el mismo tenantId.","tags":["Search"],"parameters":[{"in":"path","name":"tenantId","schema":{"$ref":"#/components/schemas/TenantId"},"required":true}],"requestBody":{"description":"Json con la imagen de entrada codificada en formato base64 RFC4648 y las opciones de búsqueda.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchImageBody"}}}},"responses":{"200":{"description":"El resultado de la búsqueda, una lista de ids de template.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Llegan parámetros incorrectos en la solicitud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResult"}}}},"500":{"description":"Se ha producido un error en la llamada al backend de Voice-SDK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExceptionResult"}}}}}}}}}
```