> For the complete documentation index, see [llms.txt](https://devcenter.unico.io/unico-idcloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devcenter.unico.io/unico-idcloud/by-unico-integration/pt/by-unico-api/api-reference/consultar-resultado-do-processo.md).
# Consultar Resultado do Processo
{% hint style="info" %}
**URL Base**:
* UAT: `https://api.cadastro.uat.unico.app`.
* Produção: `https://api.cadastro.unico.app`.
{% endhint %}
***
## Consultar Resultado do Processo
> Endpoint para buscar o resultado de um processo no by Unico.
```json
{"openapi":"3.0.0","info":{"title":"GetProcess","version":"1.0.0"},"servers":[{"url":"https://api.cadastro.uat.unico.app"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/client/v1/process/{processId}":{"get":{"summary":"Consultar Resultado do Processo","description":"Endpoint para buscar o resultado de um processo no by Unico.","parameters":[{"name":"processId","in":"path","required":true,"description":"ID do processo.","schema":{"type":"string"}}],"responses":{"200":{"description":"Detalhes do processo obtidos com sucesso.","content":{"application/json":{"schema":{"type":"object","properties":{"process":{"type":"object","description":"Informações do processo by Unico.","properties":{"id":{"type":"string","description":"ID do processo."},"flow":{"type":"string","description":"Fluxo utilizado no processo."},"callbackUri":{"type":"string","description":"URI de callback."},"userRedirectUrl":{"type":"string","description":"URL de redirecionamento do usuário."},"state":{"type":"string","enum":["PROCESS_STATE_CREATED","PROCESS_STATE_FAILED","PROCESS_STATE_FINISHED"],"description":"Estado do processo. Valores possíveis: 'PROCESS_STATE_CREATED' - Processo criado; 'PROCESS_STATE_FINISHED' - Processo finalizado; PROCESS_STATE_FAILED' - Processo com falha."},"result":{"type":"string","enum":["PROCESS_RESULT_OK","PROCESS_RESULT_ERROR","PROCESS_RESULT_INVALID_IDENTITY","PROCESS_RESULT_UNSPECIFIED","PROCESS_RESULT_EXPIRED"],"description":"Resultado do processo. Valores possíveis: 'PROCESS_RESULT_OK' - Processo finalizado com sucesso; 'PROCESS_RESULT_EXPIRED' - Processo expirado; 'PROCESS_RESULT_ERROR' - Processo finalizado com erro; 'PROCESS_RESULT_INVALID_IDENTITY' - Processo finalizado com recusa na Prova de Vida, resultado 'inconclusivo' (em flows com apenas Verificação de Identidade), divergência prolongada (em flows com score de risco) ou recusa na identidade (retorno 'negative' na Verificação de Identidade ou na Validação 1:1); 'PROCESS_RESULT_UNSPECIFIED' - Processo ainda não foi finalizado; 'PROCESS_RESULT_REFUSED' - Quando o cliente não reconhece a transação."},"createdAt":{"type":"string","description":"Data de criação do processo."},"finishedAt":{"type":"string","description":"Data de finalização do processo."},"person":{"type":"object","properties":{"duiType":{"type":"string","description":"Tipo de documento de identificação."},"duiValue":{"type":"string","description":"Valor do documento de identificação."},"friendlyName":{"type":"string","description":"Nome da pessoa."},"notifications":{"type":"array","description":"Informações sobre as notificações.","items":{"type":"object","properties":{"notificationChannel":{"type":"string","description":"Canal de notificação."}}}}}},"purpose":{"type":"string","description":"Propósito do processo."},"authenticationInfo":{"type":"object","description":"Informações da autenticação.","properties":{"authenticationResult":{"type":"string","enum":["AUTHENTICATION_RESULT_UNSPECIFIED","AUTHENTICATION_RESULT_INCONCLUSIVE","AUTHENTICATION_RESULT_POSITIVE","AUTHENTICATION_RESULT_NEGATIVE"],"description":"Resultado da capacidade Verificação de Identidade. Valores possíveis: 'AUTHENTICATION_RESULT_UNSPECIFIED' - retorno caso não use o flow com Verificação de Identidade ou alguma falha; 'AUTHENTICATION_RESULT_INCONCLUSIVE' - não conseguimos afirmar com precisão se a face é a titular do CPF. Único retorno onde haverá a orquestração com o Score de risco; 'AUTHENTICATION_RESULT_POSITIVE' - a face é a do titular do CPF; AUTHENTICATION_RESULT_NEGATIVE - a face não é a do titular do CPF."},"authenticationId":{"type":"string","description":"ID da autenticação."},"livenessResult":{"type":"string","enum":["LIVENESS_RESULT_UNSPECIFIED","LIVENESS_RESULT_LIVE","LIVENESS_RESULT_NOT_LIVE"],"description":"Resultado da capacidade Prova de vida. Valores possíves: 'LIVENESS_RESULT_UNSPECIFIED' - está associado a alguma falha; 'LIVENESS_RESULT_LIVE' - o usuário estava ao vivo no momento da captura; 'LIVENESS_RESULT_NOT_LIVE' - o usuário não estava ao vivo no momento da captura."},"bioTokenEngineResult":{"type":"string","enum":["BIO_TOKEN_ENGINE_RESULT_UNSPECIFIED","BIO_TOKEN_ENGINE_RESULT_POSITIVE","BIO_TOKEN_ENGINE_RESULT_NEGATIVE"],"description":"Resultado da capacidade Validação 1:1. Valores possíveis: 'BIO_TOKEN_ENGINE_RESULT_UNSPECIFIED' - retorno caso não use o flow com Validação 1:1 ou alguma falha; 'BIO_TOKEN_ENGINE_RESULT_POSITIVE' - a face do usuário é a mesma do processo de referência; 'BIO_TOKEN_ENGINE_RESULT_NEGATIVE' - a face do usuário não é a mesma do processo de referência"},"trustResult":{"type":"string","enum":["TRUST_RESULT_UNSPECIFIED"],"description":"Campo depreciado."},"identityFraudstersResult":{"type":"string","enum":["TRUST_RESULT_UNSPECIFIED","TRUST_RESULT_INCONCLUSIVE","TRUST_RESULT_YES"],"description":"Resultado da capacidade Alerta de Comportamento. Valores possíveis: 'TRUST_RESULT_UNSPECIFIED' - retorno caso não use o flow com Alerta de comportamento ou alguma falha; 'TRUST_RESULT_INCONCLUSIVE' - não encontramos nenhum indicativo de fraude com esta face; 'TRUST_RESULT_YES' - encontramos fraudes associadas a esta face."},"faceWithOtherIdResult":{"type":"string","enum":["TRUST_RESULT_UNSPECIFIED"],"description":"Campo depreciado."},"frictionlessResult":{"type":"string","enum":["FRICTIONLESS_RESULT_UNSPECIFIED"],"description":"Campo depreciado."},"riskLevelResult":{"type":"string","enum":["TRUST_RESULT_UNSPECIFIED"],"description":"Campo depreciado."},"smartRevalidationResult":{"type":"string","enum":["SMART_REVALIDATION_RESULT_UNSPECIFIED","SMART_REVALIDATION_RESULT_POSITIVE","SMART_REVALIDATION_RESULT_NEGATIVE"],"description":"Resultado da capacidade Revaldação Inteligente. Valores possíveis: 'IDSMART_RESULT_UNSPECIFIED' - retorno caso não use o flow com Revalidação Inteligente ou alguma falha; 'IDSMART_RESULT_POSITIVE' - o usuário é o mesmo do processo de referência; 'IDSMART_RESULT_NEGATIVE' - o usuário não é o mesmo do processo de referência."},"idAgeResult":{"type":"string","enum":["ID_AGE_RESULT_UNSPECIFIED","ID_AGE_RESULT_POSITIVE","ID_AGE_RESULT_NEGATIVE","ID_AGE_RESULT_INCONCLUSIVE"],"description":"Resultado da validação de idade. Valores possíveis: 'ID_AGE_RESULT_UNSPECIFIED' - retorno caso não use o flow com Validação de Idade ou alguma falha; 'ID_AGE_RESULT_POSITIVE' - A pessoa foi verificada como maior de idade (18+); 'ID_AGE_RESULT_NEGATIVE' - A pessoa foi verificada como menor de idade (menos de 18 anos); 'ID_AGE_RESULT_INCONCLUSIVE' - A verificação da idade legal não pôde ser realizada devido a dados insuficientes ou conflitantes."},"scoreEngineResult":{"type":"object","description":"Informações da capacidade Score de risco.","properties":{"scoreEnabled":{"type":"string","enum":["SCORE_ENABLED_TRUE","SCORE_ENABLED_FALSE"],"description":"Indica se o score está habilitado."},"score":{"type":"number","description":"Resultado da capacidade Score de risco. Só é devolvido um score que deva ser interpretado nos casos onde o authenticatioResult é AUTHENTICATION_RESULT_INCONCLUSIVE."}}},"serproResult":{"type":"object","description":"Informações do score de similaridade da Serpro. Só é devolvido para os flows com idSerpro. Quando a Serpro encontra a face, é devolvido em score de 0-10. Quando a Serpro não encontra a face, é devolvido o score -1. Quando há algum erro na integração com a Serpro, é devolvido o score -2.","properties":{"score":{"type":"number","description":"Resultado da funcionalidade Score de similaridade da Serpro."}}}}},"capacities":{"type":"array","items":{"type":"string"},"description":"Capacidades do processo."},"services":{"type":"array","description":"Informações do uso de documentos ou assinatura eletrônica ou idcash.","items":{"type":"object","properties":{"documents":{"type":"array","items":{"type":"object","properties":{"doc":{"type":"object","properties":{"version":{"type":"number","description":"Versão do documento."},"code":{"type":"string","description":"Código do documento."},"data":{"type":"object","properties":{"dataExpiracao":{"type":"string","description":"Data de expiração do documento."},"dataHabilitacao":{"type":"string","description":"Data de habilitação do documento."},"dataNascimento":{"type":"string","description":"Data de nascimento da pessoa."},"nomeCivil":{"type":"string","description":"Nome civil da pessoa."},"rgNumero":{"type":"string","description":"Número do RG."},"categoria":{"type":"string","description":"Categoria."},"cpfNumero":{"type":"string","description":"Número do CPF."},"dataEmissao":{"type":"string","description":"Data de emissão do documento."},"localEmissao":{"type":"string","description":"Local de emissão do documento."},"numero":{"type":"string","description":"Número do documento."},"renachNumero":{"type":"string","description":"Número do RENACH."}}}}},"typified":{"type":"boolean","description":"Indica se o documento foi tipificado."},"cpf_match":{"type":"boolean","description":"Indica se o CPF confere com o documento."},"face_match":{"type":"boolean","description":"Indica se o rosto confere com o documento."},"doc_id":{"type":"string","description":"ID do documento."},"validate_doc":{"type":"boolean","description":"Indica se o documento foi validado."},"reused_doc":{"type":"boolean","description":"Indica se o documento foi reutilizado."},"signed_url":{"type":"string","description":"URL assinada para o documento."}}}},"consent_granted":{"type":"boolean","description":"Indica se o consentimento foi concedido."},"envelopeId":{"type":"string","description":"ID do envelope de documentos."},"documentIds":{"type":"array","items":{"type":"string"},"description":"IDs dos documentos."}}}},"expiresAt":{"type":"string","description":"Data de expiração do processo."},"token":{"type":"string","description":"Token assinado que contém os parâmetros necessários para inicializar o SDK web do by Unico, permitindo integração via iFrame."},"companyData":{"type":"object","description":"Informações da empresa onde o processo foi criado. Referente ao campo 'companyBranchId', utilizado na criação do processo.","properties":{"branchId":{"type":"string"},"countryCode":{"type":"string"}}},"bioTokenData":{"type":"object","description":"Informações do processo de referência do token biométrico.","properties":{"referenceProcessId":{"type":"string"},"authenticationId":{"type":"string"}}},"clientReference":{"type":"string","required":true,"description":"É um identificador não obrigatório que será utilizado como indexador no portal e você pode utilizar como forma de associação (foreign key) entre seu sistema e o IDCloud."},"useCase":{"type":"string","required":false,"description":"É o caso de uso referente a revalidação inteligente."}}}}}}}},"400":{"description":"Payload inválido.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Error code."},"message":{"type":"string","description":"Error description."},"details":{}}}}}},"401":{"description":"Erro no access-token.","content":{"application/json":{"schema":{"type":"string","description":"Error description."}}}},"404":{"description":"Processo não encontrado.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Error code."},"message":{"type":"string","description":"Error description."},"details":{}}}}}}}}}}}
```
{% hint style="warning" %}
* O documento é imutável: uma vez informado (seja na criação do processo ou por meio deste endpoint), ele não pode ser alterado.
* O processo não pode estar finalizado nem expirado no momento da chamada.
* O valor enviado em `duiValue` deve seguir o formato do tipo informado em `duiType`, sem pontos, traços ou qualquer outra formatação.
{% endhint %}
{% hint style="success" %}
**Dicas:**
* Após o retorno de sucesso deste endpoint, utilize o endpoint **Consultar Resultado do Processo** para acompanhar o resultado final, ou configure Webhooks para ser notificado quando o processo for finalizado.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://devcenter.unico.io/unico-idcloud/by-unico-integration/pt/by-unico-api/api-reference/consultar-resultado-do-processo.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.