A API de verificação de NIF's (TIN) facilita a validação de números de NIF (TIN) para mais de 100 países. A API retorna respostas codificadas em JSON e usa códigos de resposta HTTP padrão.

Como funciona?

Deve criar sua conta aqui e receberá 10 créditos gratuitos para poder fazer os primeiros testes.
Para poder fazer a primeira solicitação por API, deve gerar o Token conforme indicado no manual da API na área restrita.

Posso validar um NIF (TIN) sem necessitar integrar uma API?

Sim, mas deverá criar sua conta aqui e na área restrita. terá acesso a um validador manual de NIF's (TIN).

Exemplo:

Exemplo de solicitação de API de verificação de NIF (TIN):

Exemplos de respostas da API:

Neste caso, o número enviado foi muito curto. A mensagem se adapta para fornecer orientação específica quando disponível.

Quando o resultado é válido.

Desde que o próprio pedido esteja devidamente formatado, a resposta será sempre devolvida com um código de estado 200, mesmo que o número TIN não seja válido. Se houver um problema com a própria solicitação (por exemplo, um código de país ausente), um código de status 4XX ou 5XX será retornado.

Parâmetros de consulta

No mínimo, a consulta deve incluir um nif (tn), token (tk), país (ca) e um operação (op).

---

nif (tn) required

O número NIF pode conter números, letras (minúsculas) traços ou sublinhados.

token (tk) required

O Token pode conter números, letras (minúsculas).

país (ca) required

Um código de país de duas letras, conforme definido no ISO standard

operação (op) required

A operação pode conter apenas 2 letras (minúsculas). ex. (tc, tl, vc)

Disponibilidade do validador por país

A seguir está uma lista de países atualmente suportados por nossa API de validação de TIN.

Para TINs de outros países, você deve obter mais informações no manual da API em api.tin-check.com

---