Validar um codice fiscale italiano e conferi-lo com os dados pessoais

POST

/v1/validate/fiscal-code

curl --request POST \
  --url https://api.vimine.network/v1/validate/fiscal-code \
  --header 'Content-Type: application/json' \
  --data '{ "code": "example", "first_name": "example", "last_name": "example", "gender": "M", "date": "2026-04-15", "place": "example", "country": "example" }'

• Vimine API

Estrutura + caractere de controle; com first_name / last_name / date / place ou country, também a coerência dos dados pessoais — e o que o próprio código traz. O formulário de adesão faz a mesma verificação, sem o sexo (ali ele não é conferido).

Corpo da requisição^obrigatório

Tipo de mídiaapplication/json

object

code

obrigatório

Codice fiscale (16 caracteres)

string

first_name

string

last_name

string

gender

string

Valores permitidos: M F

date

Data de nascimento

string formato: date

place

Local de nascimento: o comune, para uma pessoa nascida na Itália

string

country

País de nascimento, ISO 3166-1 alpha-2. Um código traz o comune para quem nasceu na Itália e só o PAÍS para todos os outros: qualquer valor que não seja IT é comparado com esse país e place é ignorado

string

>= 2 caracteres <= 2 caracteres

Respostas

200

Resultado da validação

Tipo de mídiaapplication/json

object

valid

boolean

error

string

nullable

Valores permitidos: invalid mismatch

mismatches

O que não confere com o código, quando error é mismatch

Array<string>

Valores permitidos: lastName firstName gender date place

hints

names_swapped: o código confere trocando sobrenome e nome

Array<string>

Valores permitidos: names_swapped

birth_date

A data de nascimento que o próprio código traz

string formato: date

nullable

birth_country

O país de nascimento que o próprio código traz, ISO 3166-1 alpha-2 (IT para um comune)

string

nullable

Exemplo

{
  "error": "invalid",
  "mismatches": [
    "lastName"
  ],
  "hints": [
    "names_swapped"
  ]
}

400

Requisição inválida

Tipo de mídiaapplication/problem+json

object

type

obrigatório

string formato: uri

title

obrigatório

string

status

obrigatório

integer

detail

string

code

obrigatório

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Exemplo^gerado

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Não encontrado

Tipo de mídiaapplication/problem+json

object

type

obrigatório

string formato: uri

title

obrigatório

string

status

obrigatório

integer

detail

string

code

obrigatório

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Exemplo^gerado

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

429

Limite de requisições excedido

Tipo de mídiaapplication/problem+json

object

type

obrigatório

string formato: uri

title

obrigatório

string

status

obrigatório

integer

detail

string

code

obrigatório

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Exemplo^gerado

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Erro interno

Tipo de mídiaapplication/problem+json

object

type

obrigatório

string formato: uri

title

obrigatório

string

status

obrigatório

integer

detail

string

code

obrigatório

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Exemplo^gerado

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}