Codice Fiscale (TIN)

Validazione formale (non controlla se esista realmente) di un codice fiscale all'interno dell'Unione Europea

Controlla la validità formale di un codice fiscale

POST https://api.gsped.it/[ISTANZA]/validation/tin

Headers

Name	Type	Description
x-api-key*	String	APIKEY fornita da Gsped

Request Body

Name	Type	Description
country*	String	Nazione c.f. in ISO-2 code
value*	String	Valore c.f. da controllare

200: OK Chiamata corretta

Chiamata effettuata, verificare se valido dalla risposta (campo isValid)

{
    "result": {
        "isValid": true, // cumulativo di sintassi e struttura corrette
        "infos": {
            "countryCode": "IT",
            "tinNumber": "RSSMRA80A01A182N",
            "validStructure": true,
            "validSyntax": true,
            "statusCode": 200 // risposta servizio di validazione interrogato
        }
    },
    "code": 200 // codice risposta Gsped ripetuto nel payload
}

400: Bad Request Dati non corretti

Campo error con descrizione dell'errore

{
    "error": "country: This value should have exactly 2 characters.",
    "code": 400
}

500: Internal Server Error Errore durante la validazione

{
    "error": "Errore durante il processo di validazione",
    "code": 500
}