> ## Documentation Index > Fetch the complete documentation index at: https://documentacao.legitimuz.com/llms.txt > Use this file to discover all available pages before exploring further. # LegitID > O que o LegitID responde sobre um CPF e uma selfie, como ler o Score de Identidade e como liberar o produto na sua chave. O LegitID responde a uma pergunta: **qual a confiança de que esta selfie pertence ao CPF informado?** O seu servidor envia o CPF e uma selfie e recebe o Score de Identidade, de 0 a 100, sem abrir a jornada de verificação para o titular. A chamada é uma só, síncrona: [`POST /v1/legitid/verifications`](https://documentacao.legitimuz.com/api/legitid-verifications). ## Quando usar | Use o LegitID | Use a [verificação completa](https://documentacao.legitimuz.com/api/create-verification.md) | | - | - | | Você já tem a selfie e o CPF do titular | O titular ainda vai capturar a selfie e o documento | | Quer saber se o rosto pertence ao CPF | Precisa de prova de vida, documento e regras de fluxo | | Quer uma resposta na mesma chamada | Aceita receber o desfecho por webhook | ## Como funciona **1. A Legitimuz consulta a própria base biométrica** Se a base tem o CPF e a comparação com a selfie é conclusiva, a consulta termina aqui. **2. Se não houver resposta conclusiva, consulta bases biométricas parceiras** Uma por vez, em ordem fixa. A primeira resposta conclusiva encerra a busca. Não há votação nem média entre bases. Resposta inconclusiva, CPF ausente naquela base ou tempo esgotado passam a vez para a próxima. **3. Se nenhuma base for conclusiva, entra a evidência auxiliar** Só quando pelo menos uma base achou o CPF e deu resultado inconclusivo. A idade e o gênero estimados na selfie são comparados com o cadastro do CPF: compatíveis dão 40, incompatíveis dão 20\. Quando a evidência auxiliar não pode ser feita, o score é 0. Isso acontece, por exemplo, quando a selfie não tem rosto, tem mais de um rosto, ou o cadastro do CPF não tem os dados para comparar. Quando nenhuma base tem o CPF, o score também é 0. ## Régua do Score de Identidade O `identity_score` assume só sete valores. | Score | Significado | | -: | - | | `100` | É a pessoa, evidência máxima | | `90` | É a pessoa, evidência muito forte | | `80` | É a pessoa, evidência forte | | `40` | Evidência moderada: idade e gênero estimados na selfie compatíveis com o cadastro do CPF | | `20` | Baixa confiança: idade ou gênero não compatíveis com o cadastro do CPF | | `10` | Identidade não confiável: há evidência de que a selfie não é da pessoa | | `0` | Sem resultado biométrico: não há evidência suficiente para dizer quem é | A resposta da API traz só o número. A classificação e a recomendação ficam aqui, na documentação. ### Recomendação por faixa | Faixa | Recomendação | | - | - | | 70 a 100 | Aprovação | | 40 a 69 | Análise adicional | | 1 a 39 | Reprovação | | 0 | Sem resultado biométrico na base | A recomendação é uma orientação. A política de decisão é sua: cada cliente define o que fazer com cada faixa, de acordo com o próprio risco. ## Conclusivo, inconclusivo e sem evidência | Situação | Score | O que quer dizer | | - | - | - | | Uma base respondeu de forma conclusiva | `100`, `90`, `80` ou `10` | A comparação biométrica decidiu, a favor ou contra | | Bases acharam o CPF, nenhuma foi conclusiva | `40` ou `20` | Decidiu a evidência auxiliar de idade e gênero | | Nenhuma base tem o CPF, ou a evidência auxiliar não foi possível | `0` | Não há evidência para afirmar nada | ### 10 não é 0 Os dois números ficam perto na régua e dizem coisas opostas. * **10** é evidência de que a selfie **não** é da pessoa dona do CPF. Uma base comparou e concluiu que não bate. * **0** é ausência de evidência. Nenhuma base conseguiu dizer quem é. Isso não fala a favor nem contra o titular. Falha técnica nunca vira 10 nem 20. Quando nenhuma base consegue responder, a API devolve [`503 E_LEGITID_UNAVAILABLE`](https://documentacao.legitimuz.com/api/legitid-verifications#erros), não um score. O LegitID não consulta a Receita Federal. O CPF é conferido só pelo dígito verificador, então um CPF que não existe na Receita termina em 0, como qualquer CPF ausente das bases. ## Identidade não é risco O Score de Identidade responde se a pessoa é quem diz ser. Risco é outra pergunta: device, localização, histórico de fraude, reincidência. O LegitID não avalia risco. Uma selfie com score 100 diz que o rosto pertence ao CPF. Não diz que a transação é segura. Veja os [dois eixos do score](https://documentacao.legitimuz.com/platform/score.md) na verificação completa. O `identity_score` do LegitID tem régua própria, de sete níveis. Ele é independente do `identity_score` que chega no webhook `verification.scored` da verificação completa: os dois não estão na mesma escala e não devem ser comparados. ## Limitações > [!WARNING] > > O LegitID não faz prova de vida. Ele não verifica se a selfie foi capturada ao vivo: uma foto de > uma foto é aceita e comparada como qualquer outra. O produto responde só se o rosto pertence ao > dono do CPF. Se você precisa garantir que a pessoa está presente na captura, use a > [verificação completa](https://documentacao.legitimuz.com/api/create-verification.md), que tem prova de vida. * Envie uma selfie com um rosto só, de frente. Sem rosto ou com mais de um, a evidência auxiliar não roda: se nenhuma base for conclusiva, o score é 0. * O LegitID não lê documento e não confere situação cadastral na Receita Federal. * A resposta leva alguns segundos, e às vezes mais. Veja [tempo de resposta](https://documentacao.legitimuz.com/api/legitid-verifications.md#tempo-de-resposta-e-retentativa). ## Cobrança Toda resposta `200` é cobrada, inclusive o score 0. Erros (`400`, `401`, `403`, `413`, `415`, `429` e `503`) não são cobrados. ## Liberar o LegitID na chave A chamada exige uma chave de API com duas coisas: 1. **A permissão de criar verificação**, a mesma da [criação de verificação](https://documentacao.legitimuz.com/api/create-verification.md). No dashboard, ela aparece como **Criar link de verificação**. 2. **A liberação do LegitID.** Só a equipe da Legitimuz liga essa liberação, na criação da chave ou depois, no escopo dela. Peça pelo [suporte](https://painel.legitimuz.com/support) informando a integração e a chave, pelo nome ou pelo prefixo mascarado. Não envie o valor da chave. Sem uma das duas, a chamada responde `403 E_FORBIDDEN`. Na listagem de chaves, a chave liberada mostra o selo **LegitID** ao lado do status. A chave gerada pela ação **Rotacionar** herda a liberação da antiga. Uma chave criada do zero nasce sem ela: se for trocar a chave do LegitID por uma nova, peça a liberação antes de revogar a antiga. ## Sandbox Numa integração sandbox, o LegitID não consulta nenhuma base biométrica. A chave sandbox recebe um score fixo por CPF de teste, com qualquer selfie JPEG ou PNG. CPF fora da lista recebe 0. | CPF de teste | `identity_score` | | - | -: | | `72345800003` | `100` | | `73793012093` | `100` | | `56793624067` | `90` | | `77491780075` | `90` | | `96752704031` | `80` | | `53392885010` | `80` | | `43903249009` | `10` | | `69476468041` | `10` | | `61977244050` | `20` | | `40448804093` | `20` | São os mesmos [CPFs de teste](https://documentacao.legitimuz.com/start/sandbox-test-cpfs.md) da verificação completa. Eles não pertencem a ninguém, e numa integração de produção não têm tratamento especial. ## Próximo passo > [card] [Chamar a API](https://documentacao.legitimuz.com/api/legitid-verifications.md) > > Os dois formatos de requisição, a resposta e os erros. > [card] [Chaves de API](https://documentacao.legitimuz.com/platform/tokens.md) > > Crie a chave com o escopo certo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.