> ## Documentation Index
> Fetch the complete documentation index at: https://docs.go.gbgplc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SPID

> Verify identities using SPID, Italy's national digital identity framework for authentication across public and private online services.

SPID is Italy's national digital identity framework provided by various certified issuers. SPID is widely adopted—by late 2024, about 38.9 million Italians (nearly 80% of adults) had active SPID credentials, used for authentication across public and private online services. To learn more, visit the [SPID website](https://www.spid.gov.it/en/).

## Adoption data

This section provides insights into the adoption of SPID among users in Italy.

|                 |                                                                                                                                                                                                                                                                                          |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Adoption        | 41 million                                                                                                                                                                                                                                                                               |
| Adoption source | [https://www.unionesarda.it/en/italy/there39-s-an-agreement-on-spid-renewed-for-another-5-years-but-it-could-become-a-paid-service-i974pkpx](https://www.unionesarda.it/en/italy/there39-s-an-agreement-on-spid-renewed-for-another-5-years-but-it-could-become-a-paid-service-i974pkpx) |
| Adoption rate   | 86.81%                                                                                                                                                                                                                                                                                   |
| Coverage        | 47M                                                                                                                                                                                                                                                                                      |
| Status          | <Badge color="green">Available, live!</Badge>                                                                                                                                                                                                                                            |

## Provider ID

This is the unique identifier for this digital ID provider in the GBG GO system.

|             |              |
| ----------- | ------------ |
| Provider ID | `italy-spid` |

## Compliance

This section outlines compliance and regulatory requirements for integrating this digital ID provider.

| Compliance data           | Status                                      |
| ------------------------- | ------------------------------------------- |
| Locality requirements     | <Badge color="green">None</Badge>           |
| Scheme-level restrictions | <Badge color="yellow">None</Badge>          |
| Certifications            | <Badge color="gray">LoA High, eIDAS</Badge> |

## Supported attributes

The following attributes are returned when SPID is used for identity verification:

### Always returned attributes

The following attributes are always returned from a successful verification from this ID Provider.

| Field                                               | Description               |
| --------------------------------------------------- | ------------------------- |
| <Badge color="green">firstName</Badge>              | User’s first name         |
| <Badge color="gray">lastNames</Badge>               | User’s last name          |
| <Badge color="orange">dateOfBirth</Badge>           | User’s date of birth      |
| <Badge color="purple">document type</Badge>         | Type of identity document |
| <Badge color="yellow">document number</Badge>       | Identity document number  |
| <Badge color="green">document issueDate</Badge>     | Document issue date       |
| <Badge color="gray">document expirationDate</Badge> | Document expiration date  |

### Sometimes returned attributes

The following attributes are only sometimes returned from a successful verification from this ID Provider.

| Field                                                 | Description                |
| ----------------------------------------------------- | -------------------------- |
| <Badge color="green">sex</Badge>                      | User’s gender              |
| <Badge color="gray">phoneNumber</Badge>               | User’s phone number        |
| <Badge color="yellow">line1</Badge>                   | Street address             |
| <Badge color="purple">city</Badge>                    | City of residence          |
| <Badge color="orange">subdivision</Badge>             | State, province, or region |
| <Badge color="green">postalCode</Badge>               | Postal or ZIP code         |
| <Badge color="gray">country</Badge>                   | Country of residence       |
| <Badge color="purple">document expirationDate</Badge> | Document expiration date   |

## Additional attributes (Integration guide examples)

The following additional attributes may be returned when SPID is used for identity verification:

### Always returned additional attributes

These additional attributes are always returned from a successful verification from this ID Provider.

| Path in the response                                                                    | Description                                        |
| --------------------------------------------------------------------------------------- | -------------------------------------------------- |
| <Badge color="green">DigitalId\_GetResults.result.advice.providerID</Badge>             | Provider ID, always "italy-spid".                  |
| <Badge color="gray">DigitalId\_GetResults.result.advice.subProviderID</Badge>           | SPID IDP provider ID (GBG internal ID).            |
| <Badge color="yellow">DigitalId\_GetResults.result.subject.identity.firstName</Badge>   | The first name of the user.                        |
| <Badge color="purple">DigitalId\_GetResults.result.subject.identity.lastNames</Badge>   | The last name of the user.                         |
| <Badge color="orange">DigitalId\_GetResults.result.subject.identity.dateOfBirth</Badge> | The date of birth of the user (format YYYY-MM-DD). |

### Sometimes returned additional attributes

These additional attributes are only sometimes returned from a successful verification from this ID Provider.

| Path in the response                                                                                                                                                                    | Description                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| <Badge color="purple">DigitalId\_GetResults.result.subject.identity.gender</Badge>                                                                                                      | The gender of the user (M or F).                           |
| <Badge color="orange">DigitalId\_GetResults.result.subject.identity.phones</Badge>                                                                                                      | The phone number of the user.                              |
| <Badge color="yellow">DigitalId\_GetResults.result.subject.identity.emails</Badge>                                                                                                      | The email address of the user.                             |
| <Badge color="green">DigitalId\_GetResults.result.subject.identity.currentAddress.lines</Badge>                                                                                         | The residential address of the user.                       |
| <Badge color="gray">DigitalId\_GetResults.result.subject.identity.currentAddress.locality</Badge>                                                                                       | City or locality of residence.                             |
| <Badge color="purple">DigitalId\_GetResults.result.subject.identity.currentAddress.administrativeArea</Badge>                                                                           | Administrative area or province of residence.              |
| <Badge color="yellow">DigitalId\_GetResults.result.subject.identity.currentAddress.postalCode</Badge>                                                                                   | Postal code of the residence.                              |
| <Badge color="orange">DigitalId\_GetResults.result.subject.identity.currentAddress.country</Badge>                                                                                      | Country of residence (ISO country code).                   |
| <Badge color="green">DigitalId\_GetResults.result.subject.documents\[?(@.documentType == 'Passport' \|\| @.documentType == 'ID Card' \|\| @.documentType == 'Driving Licence')]</Badge> | Identity document (Passport, Driving Licence, or ID Card). |
| <Badge color="gray">DigitalId\_GetResults.result.subject.documents\[0].issueDate</Badge>                                                                                                | Issue date of the identity document.                       |
| <Badge color="purple">DigitalId\_GetResults.result.subject.documents\[0].expiryDate</Badge>                                                                                             | Expiry date of the identity document.                      |
| <Badge color="yellow">DigitalId\_GetResults.result.subject.documents\[0].country</Badge>                                                                                                | Country of issuance of the identity document.              |
| <Badge color="orange">DigitalId\_GetResults.result.subject.documents\[?(@.documentType == 'Tax ID')].documentNumber</Badge>                                                             | Tax ID (Codice Fiscale) of the user.                       |
| <Badge color="green">DigitalId\_GetResults.result.note.italy-spid.rawIdCard</Badge>                                                                                                     | Raw SPID identity document string provided by the IdP.     |
| <Badge color="gray">DigitalId\_GetResults.result.note.italy-spid.identityProviderEntityId</Badge>                                                                                       | Identity Provider ID (as provided by SPID).                |
| <Badge color="purple">DigitalId\_GetResults.result.note.italy-spid.spidCode</Badge>                                                                                                     | The IdP (SPID) unique code of the user.                    |
| <Badge color="yellow">DigitalId\_GetResults.result.note.italy-spid.spidCredentialExpirationDate</Badge>                                                                                 | Identity document expiration date (format YYYY-MM-DD).     |
| <Badge color="orange">DigitalId\_GetResults.result.note.italy-spid.placeOfBirth</Badge>                                                                                                 | Place of birth (Belfiore code of municipality or country). |
| <Badge color="green">DigitalId\_GetResults.result.note.italy-spid.countyOfBirth</Badge>                                                                                                 | County (province) of birth (e.g. MI, EE for abroad).       |