驗證義大利稅號（codice fiscale），並與個人資訊比對

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

結構 + 檢查碼；提供 first_name / last_name / date / place 或 country 時，還會檢查與個人資訊的一致性——並說明稅號本身包含什麼。入會表單執行相同的檢查，但不含性別（入會時不比對性別）。

請求本文^必填

媒體類型application/json

object

code

必填

稅號（codice fiscale，16 個字元）

string

first_name

string

last_name

string

gender

string

允許的值： M F

date

出生日期

string 格式： date

place

出生地：在義大利出生的人為市鎮（comune）

string

country

出生國，ISO 3166-1 alpha-2。在義大利出生的人，稅號中包含市鎮（comune）；其他所有人的稅號中則只包含國家：IT 以外的任何值都會與該國家比對，並忽略 place

string

>= 2 個字元 <= 2 個字元

回應

200

驗證結果

媒體類型application/json

object

valid

boolean

error

string

可為 null

允許的值： invalid mismatch

mismatches

error 為 mismatch 時，與稅號不一致的內容

Array<string>

允許的值： lastName firstName gender date place

hints

names_swapped：姓和名互換後，稅號即可對上

Array<string>

允許的值： names_swapped

birth_date

稅號本身包含的出生日期

string 格式： date

可為 null

birth_country

稅號本身包含的出生國，ISO 3166-1 alpha-2（在義大利市鎮出生則為 IT）

string

可為 null

範例

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

400

請求無效

媒體類型application/problem+json

object

type

必填

string 格式： uri

title

必填

string

status

必填

integer

detail

string

code

必填

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

範例^自動產生

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

404

找不到

媒體類型application/problem+json

object

type

必填

string 格式： uri

title

必填

string

status

必填

integer

detail

string

code

必填

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

範例^自動產生

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

429

超出速率限制

媒體類型application/problem+json

object

type

必填

string 格式： uri

title

必填

string

status

必填

integer

detail

string

code

必填

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

範例^自動產生

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

500

內部錯誤

媒體類型application/problem+json

object

type

必填

string 格式： uri

title

必填

string

status

必填

integer

detail

string

code

必填

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

範例^自動產生

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