# 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

<mark style="color:green;">`POST`</mark> `https://api.gsped.it/[ISTANZA]/validation/tin`

#### Headers

| Name                                        | Type   | Description             |
| ------------------------------------------- | ------ | ----------------------- |
| x-api-key<mark style="color:red;">\*</mark> | String | APIKEY fornita da Gsped |

#### Request Body

| Name                                      | Type   | Description                |
| ----------------------------------------- | ------ | -------------------------- |
| country<mark style="color:red;">\*</mark> | String | Nazione c.f. in ISO-2 code |
| value<mark style="color:red;">\*</mark>   | String | Valore c.f. da controllare |

{% tabs %}
{% tab title="200: OK Chiamata corretta" %}
Chiamata effettuata, verificare se valido dalla risposta (campo isValid)

```json
{
    "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
}
```

{% endtab %}

{% tab title="400: Bad Request Dati non corretti" %}
Campo error con descrizione dell'errore

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

{% endtab %}

{% tab title="500: Internal Server Error Errore durante la validazione" %}

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

{% endtab %}
{% endtabs %}