---
title: "Buscar face na coleção"
method: POST
path: "/faces/buscar"
tags: ["Biometria Facial 1:N"]
---

# Buscar face na coleção

`POST /faces/buscar`

### Descrição

A **busca de face na coleção** é a operação central da **Biometria Facial 1:N** do **BigID**, responsável por comparar uma imagem de rosto enviada com todas as faces previamente cadastradas em uma coleção. Utilizando modelos avançados de Inteligência Artificial, a tecnologia identifica as faces mais semelhantes e retorna os respectivos índices de similaridade e identificadores associados.

Essa funcionalidade é amplamente utilizada em fluxos de autenticação, controle de acesso, identificação de usuários e detecção de tentativas de fraude. Quando configurada para retornar múltiplos resultados, a tecnologia pode apresentar até **6 correspondências**, considerando apenas faces com **índice mínimo de similaridade de 70%**, ordenadas da maior para a menor similaridade. Caso menos resultados atendam a esse critério, apenas as correspondências válidas são retornadas.

Para mais informações sobre casos de uso, principais dúvidas e orientações de aplicação, acesse [Biometria Facial](/docs/biometria-facialfacematch).

### Tabela de preços

A cobrança é realizada conforme o volume mensal de consultas, de acordo com a tabela abaixo:

| Consultas realizadas no mês | Valor por consulta |
|:---------------------------:|:------------------:|
| 1 – 10.000 | R$ 0,170 |
| 10.001 – 50.000 | R$ 0,162 |
| 50.001 – 100.000 | R$ 0,153 |
| 100.001 – 500.000 | R$ 0,146 |
| 500.001 – 1.000.000 | R$ 0,138 |
| 1.000.001 – 5.000.000 | R$ 150.000,00 (preço fixo) |
| Acima de 5.000.000 | [Entre em contato](mailto:comercial@bigdatacorp.com.br) |

## Request body

- SearchFaceRequest — Objeto de request para busca de face na Biometria Facial 1:N.
  - `face_image` string, required — Imagem de rosto em Base64 ou URL.
  - `base_db` string, required — Identificador da coleção onde a busca será realizada.
  - `PrivateUrl` boolean — Indica se a URL da imagem está em diretório privado.
  - `all_faces` boolean — Define se devem ser retornadas múltiplas faces com maior similaridade (até 6 resultados acima de 70%).

## Response `200`

Resultado da busca de face na coleção.

- SearchFaceResult — Estrutura de retorno da busca de face na Biometria Facial 1:N.
  - `Document` string — Tipo de documento associado à face encontrada.
  - `Document_Number` string — Número do documento associado à face encontrada.
  - `Similarity` number[] — Índices de similaridade calculados entre a imagem enviada e as encontradas.
  - `deepFakeIndicator` number — Indicador com percentual de probabilidade de ser deepfake
  - `velocityIndicator` boolean — Indicador de velocity
  - `ResultCode` integer — Código de resultado.
  - `TicketId` string — Identificador da operação.
  - `Message` string — Mensagem de resultado.
  - `success` boolean — Indica se a operação foi bem-sucedida.

---

[API](https://skmtc.dev/bigdatacorp/apis/bigid.md) · [All operations](https://skmtc.dev/bigdatacorp/apis/bigid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdatacorp/bigid/revisions/74abe72d7efc/schema)