The Italian version constitutes the only official and legally binding version of the document. The English-language version of this document is provided solely as a courtesy to facilitate consultation by users. In the event of any discrepancies, interpretive differences, or inconsistencies between the Italian-language version and any translated version, the Italian text alone shall prevail and be deemed authoritative.

Service metadata

description


Description	Description of the service in markdown format
Type	String
Mandatory	Yes, if the flag is_visible è true

To test the syntax in markdown, you can use an [online service such as Stackedit](https://stackedit.io/app).

privacy_url


Description	Web address that contains the privacy policy for the service
Type	String
Mandatory	Yes

scope


Description	Property that inserts the service in the list of local or national services. The possible values are: LOCAL for local services (e.g. municipalities) NATIONAL for national services (e.g. national, regional ministries, agencies/institutions)
Type	String (LOCAL\|NATIONAL)
Mandatory	Yes

address


Description	Address of the institution or department providing the service
Type	String
Mandatory	No

app_android


Description	If the service requires the use of a specific app, the link must be indicated here to download it from the Google Play Store (Android)
Type	String
Mandatory	No

app_ios


Description	If the service requires the use of a specific app, the link must be indicated here to download it from the App Store (iOS)
Type	String
Mandatory	No

cta

This function is in beta testing: do not use this field.


Description	Property that makes it possible to create customized buttons on the service tab
Type	String
Mandatory	No

email


Description	Email address of the institution or department providing the service
Type	String
Mandatory	At least one or more direct contact channels from which the citizen can request support (phone, email, pec, support_url).

pec (certified email)


Description	PEC address (certified email) of the institution/operational unit providing the service
Type	String
Mandatory	At least one or more direct contact channels from which the citizen can request support (phone, email, pec, support_url).

phone


Description	Telephone number of the institution/operational unit providing the service
Type	String
Mandatory	At least one or more direct contact channels from which the citizen can request support (phone, email, pec, support_url).

support_url


Description	Web address for requesting support from the institution/operational unit providing the service
Type	string
Mandatory	At least one or more direct contact channels from which the citizen can request support (phone, email, pec, support_url).

token_name

This function is in beta testing: do not use this attribute.


Description	Name of the token used for the Single Sign On (SSO) process via the IO app and a service provided by the institution
Type	String
Mandatory	No

tos_url


Description	Web address that contains the terms and conditions of use for the service
Type	String
Mandatory	No

web_url


Description	Address of the website for the service
Type	Boolean
Mandatory	No

On this page

description

privacy_url

scope

address

app_android

app_ios

cta

email

pec (certified email)

phone

support_url

token_name

tos_url

web_url

Haven't completed onboarding yet and need help?

Write an email describing your problem or question to the address areariservata@assistenza.pagopa.it.

Need help with APIs and Integration?

Write an email describing your problem or question to the address:

io-service-management@pagopa.it

Tell us what you think

To report problems or give feedback, leave a comment in the GitHub space of the IO app

IO, the public services app

Table of contents