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

# Create Subject

`POST /api/v2/subject`

Recebe dados do sujeito para verificação biométrica e biográfica, e o cadastra em caso de sucesso.

**Requisitos:**

1. A imagem do documento deve ter no mínimo 1000 pixels de largura. Para melhores resultados, é recomendável que possua pelo menos 2000 pixels.
    
2. A foto do sujeito deve ter resolução mínima de 250 x 250 pixels.
    
3. Os campos Documento e QR Code são opcionais, mas pelo menos um deles deve estar presente, caso seja enviado os dois, o campo Documento será ignorado.
    
4. Para Documento e Selfie somente os formatos JPG e PNG são aceitos no momento.
    
5. Para QR Code os formatos JPG, PNG, PDF e binário são aceitos.
    
6. Tamanho de cada imagem não pode ultrapassar 5MB.
    
7. Pode ser enviado somente a foto do sujeito e o CPF, criando assim um cadastro simplificado \*
    

**Liveness:**

- Liveness pode ser usado nessa operação.
    
- 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.
    
- O resultado do liveness ('liveness_result') será incorporado ao cadastro.
    

**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))

**Datavalid:**

Caso ocorra um problema na validação dos dados no Datavalid, a API irá retornar um dos seguintes erros:

| message | **error_code** | Status HTTP |
| --- | --- | --- |
| LGPD: Dados de menor de idade | 4041 | 422 |
| CPF inválido | 4042 | 422 |
| Situação do CPF inválido | 4046 | 422 |
| Imagem da face não encontrada nas bases | 4058 | 422 |
| Não foi possível reconhecer a face na imagem | 4059 | 422 |
| Tamanho da imagem da face inválido | 4060 | 422 |
| Qualidade baixa da imagem da face | 4063 | 422 |
| Foi reconhecido mais de uma face na imagem | 4064 | 422 |
| Formato da imagem da face inválido | 4065 | 422 |

## Response `200`

- object
  - `uuid` string, required
  - `cpf` string, required
  - `data` object, required
    - `documento` string, required
    - `cnh` object, required
      - `nome` string, required
      - `identidade` string, required
      - `cpf` string, required
      - `data_nascimento` string, required
      - `nome_mae` string, required
      - `nome_pai` string, required
      - `numero_registro` string, required
      - `data_primeira_habilitacao` string, required
      - `data_ultima_emissao` string, required
      - `data_validade` string, required
      - `local` string, required
      - `local_emissao` string, required
      - `uf_emissao` string, required
      - `observacoes` string, required
      - `numero_validacao_cnh` string, required
      - `numero_renach` string, required
      - `retrato` object, required
        - `disponivel` boolean, required
        - `probabilidade` string, required
        - `similaridade` number, required
    - `validar_dados` boolean, required
    - `fonte_validacao` string, required
    - `similaridade` object, required
      - `nome` integer, required
      - `identidade` integer, required
      - `cpf` integer, required
      - `data_nascimento` integer, required
      - `nome_mae` integer, required
      - `nome_pai` integer, required
      - `numero_registro` integer, required
      - `data_primeira_habilitacao` integer, required
      - `data_ultima_emissao` integer, required
      - `data_validade` integer, required
    - `biometria_face` object, required
      - `disponivel` boolean, required
      - `probabilidade` string, required
      - `similaridade` number, required
  - `is_qualified` boolean, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `400`
- `409`
- `422`
- `500`
- `x-200:Criar Sujeito - Validação PDF CNH`
- `x-200:Criar Sujeito - Selfie + CPF`
- `x-200:Criar Sujeito - Selfie + CPF sem validação`
- `x-200:Liveness Selfie - Criar Sujeito`
- `x-200:Liveness Evidência - Criar Sujeito`
- `x-422:Campo CPF ausente`
- `x-422:Documento faltando dados`
- `x-400:Documento tipo inválido`
- `x-400:Envio de arquivo inválido`
- `x-400:Excedeu tamanho limite`
- `x-422:Datavalid Erro - Criar Sujeito`
- `x-400:Formato arquivo inválido`
- `x-400:Foto com baixa qualidade`
- `x-400:Foto baixa resolução`
- `x-422:Foto rosto não encontrado`
- `x-422:Similaridade insuficiente do documento`
- `x-422:Similaridade insuficiente selfie no Datavalid`
- `x-422:Sujeito não validado no Datavalid`

---

[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)