> ## 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.

export const VersionWarningBanner = () => {
  const [latestUrl, setLatestUrl] = useState(null);
  useEffect(() => {
    if (typeof window === "undefined") return;
    const {pathname, hash, search} = window.location;
    if (!pathname.includes("/go-v1/")) return;
    setLatestUrl(`${pathname.replace("/go-v1/", "/go-v2/")}${search}${hash}`);
  }, []);
  if (!latestUrl) return null;
  return <div className="not-prose my-6 rounded-xl border border-amber-500/30 bg-amber-500/10 px-4 py-3 text-sm text-gray-800 dark:text-gray-100">
      ⚠️ You are viewing the <strong>GBG GO v1</strong> documentation.
      <a href={latestUrl} className="ml-2 font-medium underline text-amber-700 dark:text-amber-400 hover:text-amber-800 dark:hover:text-amber-300">
        View version (v2) here →
      </a>
    </div>;
};

<VersionWarningBanner />

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).       |