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.

Get Subscriptions Feed

This mode is reserved to central institutions or institutions on a national level.
Discover how to request authorization ->

Description

The API Get Subscriptions Feed makes it possible to download the hashes of the fiscal codes of the citizens registered/deregistered to service for a specific date (UTC-YYYY-MM-DD).

The purpose of the subscription feed is to provide the central institutions with a tool to minimize phone calls to the IO infrastructure by means of a filter created by the institution itself.

The subscription feed information is updated as of the previous day. For the creation of the subscription feed, you must query the service for each day starting from 03/24/2020 up to the current date and save the data in your infrastructure.

In no case is it possible to request the fiscal code in an unencoded manner.

For technical details on how to encode fiscal codes of your system to be able to compare them with those returned from the subscription feed, expand the following section.

get

Parameters

https://raw.githubusercontent.com/teamdigitale/io-functions-services/master/openapi/index.yaml

The following is obtained with a correct response:

the status code of the response is 200
the field subscriptions and unsubscriptions is in the response body

Examples

1### REQUEST
2curl --location --request GET 'https://api.io.pagopa.it/api/v1/subscriptions-feed/2020-02-23' \
3--header 'Ocp-Apim-Subscription-Key: __YOUR_API_KEY__'
4

1### RESPONSE
2{
3"dateUTC": "2020-02-23",
4"subscriptions": [ "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" ],
5"unsubscriptions": [ ]
6}
7