Validar un código fiscal italiano y cotejarlo con los datos personales

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

Estructura + carácter de control; con first_name / last_name / date / place o country, también la coherencia con esos datos personales — y lo que contiene el propio código. El formulario de inscripción hace la misma comprobación, sin el sexo (ahí no se coteja).

Cuerpo de la petición^obligatorio

Tipo de medioapplication/json

object

code

obligatorio

Código fiscal (16 caracteres)

string

first_name

string

last_name

string

gender

string

Valores permitidos: M F

date

Fecha de nacimiento

string formato: date

place

Lugar de nacimiento: el comune, para una persona nacida en Italia

string

country

País de nacimiento, ISO 3166-1 alpha-2. Un código contiene el comune para las personas nacidas en Italia y solo el PAÍS para todas las demás: cualquier valor distinto de IT se compara con ese país y place se ignora

string

>= 2 caracteres <= 2 caracteres

Respuestas

200

Resultado de la validación

Tipo de medioapplication/json

object

valid

boolean

error

string

nullable

Valores permitidos: invalid mismatch

mismatches

Lo que no coincide con el código, cuando error es mismatch

Array<string>

Valores permitidos: lastName firstName gender date place

hints

names_swapped: el código coincide al intercambiar apellidos y nombre

Array<string>

Valores permitidos: names_swapped

birth_date

La fecha de nacimiento que contiene el propio código

string formato: date

nullable

birth_country

El país de nacimiento que contiene el propio código, ISO 3166-1 alpha-2 (IT para un comune)

string

nullable

Ejemplo

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

400

Petición no válida

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

404

No encontrado

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

429

Límite de frecuencia superado

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

500

Error interno

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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