---
title: "Identify Subject"
method: POST
path: "/api/v2/subject-identify"
tags: ["Subject-Identify"]
---

# Identify Subject

`POST /api/v2/subject-identify`

Recebe foto do sujeito e realiza um busca biométrica na base de dados para identificar o sujeito. \*

**Requisitos:**

1. A foto do sujeito deve ter resolução mínima de 250 x 250 pixels.
    
2. Somente os formatos JPG e PNG são aceitos no momento.
    
3. Tamanho da imagem não pode ultrapassar 5MB.
    

**Liveness\*:**

- O uso de liveness, por padrão, é definido pela aplicação, mas pode ser sobrescrito em cada chamada com parâmetro 'liveness', que aceita valores booleanos, presente no corpo da requisição.
    
- O teste de liveness pode ser realizado à partir de uma foto ou de uma evidência de liveness.
    
- A foto deve ser enviada no campo 'selfie'. A evidência deve ser enviada no campo 'liveness_evidence'.
    
- Caso opte por usar a evidência de livensess, a foto usada na operação será extraída da mesma.
    
- Retorna o resultado do liveness na mensagem de resposta: 'liveness_result'.
    

**Importante:** Os campos 'selfie' e 'liveness_evidence' são mutualmente exclusivos, ou seja: Não devem ser eviados juntos na mesma requisição.

Em caso de reprovação no teste de liveness, a operação é anulada.

Para mais informações sobre o exceções, leia a documentação da rota ([Liveness Validation](https://bry-developer.readme.io/reference/post_api-v2-liveness))

## Query parameters

- `getSelfie` boolean

## Response `200`

- object

## Other responses

- `400`
- `422`
- `x-200:Liveness Selfie - Biometria Identificada`
- `x-200:Liveness Evidência - Biometria Identificada`
- `x-200:Liveness Desligado - Biometria Identificada`
- `x-200:Biometria Não Identificada`
- `x-400:Excedeu Tamanho Limite`
- `x-400:Formato Arquivo Inválido`
- `x-400:Foto Baixa Qualidade`
- `x-422:Foto Rosto Não Encontrado`

---

[API](https://skmtc.net/bry/apis/bry-easy-sign-api-rest.md) · [All operations](https://skmtc.net/bry/apis/bry-easy-sign-api-rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bry/bry-easy-sign-api-rest/revisions/c87e026e87ac/schema)