SPID

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.

These docs are for businesses, not ID holders. You can’t use them to verify your own ID. For help with your ID, contact the government office that issued it.

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
Adoption rate	86.81%
Coverage	47M
Status	Available, live!

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

Get Started

Platform

Developer Integration

Digital IDs

Resources

Adoption data

Provider ID

Compliance

Supported attributes

Always returned attributes

Sometimes returned attributes

Additional attributes (Integration guide examples)

Always returned additional attributes

Sometimes returned additional attributes

​Adoption data

​Provider ID

​Compliance

​Supported attributes

​Always returned attributes

​Sometimes returned attributes

​Additional attributes (Integration guide examples)

​Always returned additional attributes

​Sometimes returned additional attributes

Adoption data

Provider ID

Compliance

Supported attributes

Always returned attributes

Sometimes returned attributes

Additional attributes (Integration guide examples)

Always returned additional attributes

Sometimes returned additional attributes