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 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.
Adoption data
This section provides insights into the adoption of SPID among users in Italy.
Provider ID
This is the unique identifier for this digital ID provider in the GBG GO system.
Compliance
This section outlines compliance and regulatory requirements for integrating this digital ID provider.
| Compliance data | Status |
|---|
| Locality requirements | None |
| Scheme-level restrictions | None |
| Certifications | LoA High, eIDAS |
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 |
|---|
| firstName | User’s first name |
| lastNames | User’s last name |
| dateOfBirth | User’s date of birth |
| document type | Type of identity document |
| document number | Identity document number |
| document issueDate | Document issue date |
| document expirationDate | Document expiration date |
Sometimes returned attributes
The following attributes are only sometimes returned from a successful verification from this ID Provider.
| Field | Description |
|---|
| sex | User’s gender |
| phoneNumber | User’s phone number |
| line1 | Street address |
| city | City of residence |
| subdivision | State, province, or region |
| postalCode | Postal or ZIP code |
| country | Country of residence |
| document expirationDate | 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 |
|---|
| DigitalId_GetResults.result.advice.providerID | Provider ID, always “italy-spid”. |
| DigitalId_GetResults.result.advice.subProviderID | SPID IDP provider ID (GBG internal ID). |
| DigitalId_GetResults.result.subject.identity.firstName | The first name of the user. |
| DigitalId_GetResults.result.subject.identity.lastNames | The last name of the user. |
| DigitalId_GetResults.result.subject.identity.dateOfBirth | 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 |
|---|
| DigitalId_GetResults.result.subject.identity.gender | The gender of the user (M or F). |
| DigitalId_GetResults.result.subject.identity.phones | The phone number of the user. |
| DigitalId_GetResults.result.subject.identity.emails | The email address of the user. |
| DigitalId_GetResults.result.subject.identity.currentAddress.lines | The residential address of the user. |
| DigitalId_GetResults.result.subject.identity.currentAddress.locality | City or locality of residence. |
| DigitalId_GetResults.result.subject.identity.currentAddress.administrativeArea | Administrative area or province of residence. |
| DigitalId_GetResults.result.subject.identity.currentAddress.postalCode | Postal code of the residence. |
| DigitalId_GetResults.result.subject.identity.currentAddress.country | Country of residence (ISO country code). |
| DigitalId_GetResults.result.subject.documents[?(@.documentType == ‘Passport’ || @.documentType == ‘ID Card’ || @.documentType == ‘Driving Licence’)] | Identity document (Passport, Driving Licence, or ID Card). |
| DigitalId_GetResults.result.subject.documents[0].issueDate | Issue date of the identity document. |
| DigitalId_GetResults.result.subject.documents[0].expiryDate | Expiry date of the identity document. |
| DigitalId_GetResults.result.subject.documents[0].country | Country of issuance of the identity document. |
| DigitalId_GetResults.result.subject.documents[?(@.documentType == ‘Tax ID’)].documentNumber | Tax ID (Codice Fiscale) of the user. |
| DigitalId_GetResults.result.note.italy-spid.rawIdCard | Raw SPID identity document string provided by the IdP. |
| DigitalId_GetResults.result.note.italy-spid.identityProviderEntityId | Identity Provider ID (as provided by SPID). |
| DigitalId_GetResults.result.note.italy-spid.spidCode | The IdP (SPID) unique code of the user. |
| DigitalId_GetResults.result.note.italy-spid.spidCredentialExpirationDate | Identity document expiration date (format YYYY-MM-DD). |
| DigitalId_GetResults.result.note.italy-spid.placeOfBirth | Place of birth (Belfiore code of municipality or country). |
| DigitalId_GetResults.result.note.italy-spid.countyOfBirth | County (province) of birth (e.g. MI, EE for abroad). |
