Get Message

Descrizione

API che controlla lo stato di invio del messaggio recuperando il contenuto. È necessario interrogare l’API con il codice fiscale del cittadino oggetto del messaggio e l’identificativo del messaggio.

Get Message

The previously created message with the provided message ID is returned. With right permission and ADVANCED feature level type related to the previously submitted message, also read and payment status infos (when applicable) are returned.

GEThttps://api.io.pagopa.it/api/v1/messages/{fiscal_code}/{id}

Authorization

SubscriptionKey

Path parameters

fiscal_code*string

The fiscal code of the user, all upper case.

Example: "SPNDNL80R13C555X"

Pattern: [A-Z]{6}[0-9LMNPQRSTUV]{2}[ABCDEHLMPRST][0-9LMNPQRSTUV]{2}[A-Z][0-9LMNPQRSTUV]{3}[A-Z]

id*string

The ID of the message.

Response

200401403404429

Message found.

Body

application/json

message*all of

notificationobject

statusall of

The processing status of a message. "ACCEPTED": the message has been accepted and will be processed for delivery; we'll try to store its content in the user's inbox and notify him on his preferred channels "THROTTLED": a temporary failure caused a retry during the message processing; any notification associated with this message will be delayed for a maximum of 7 days "FAILED": a permanent failure caused the process to exit with an error, no notification will be sent for this message "PROCESSED": the message was succesfully processed and is now stored in the user's inbox; we'll try to send a notification for each of the selected channels "REJECTED": either the recipient does not exist, or the sender has been blocked

read_statusstring

Api definition of read status enumeration

Example: "UNREAD"

payment_statusstring

Payment status enumeration

Example: "NOT_PAID"

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.io.pagopa.it/api/v1/messages/{fiscal_code}/{id}', {
    method: 'GET',
    headers: {
      "Ocp-Apim-Subscription-Key": "SubscriptionKey <apiKey>"
    },
});
const data = await response.json();

Response

200404

{
  "status": "PROCESSED",
  "message": {
    "id": "01BX9NSMKAAAS5PSP2FATZM6BQ",
    "fiscal_code": "QXJNTX9RCRVD6V4O",
    "time_to_live": 3600,
    "content": {
      "subject": "message subject, aliquip sint nulla in estinut",
      "markdown": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas et mollis felis.\nVivamus orci nisl, commodo ut sodales ut, eleifend a libero. Donec dapibus, turpis in mattis tempor,\nrisus nunc malesuada ex, non aliquet metus nunc a lacus. Aenean in arcu vitae nisl porta\nfermentum nec non nibh. Phasellus tortor tellus, semper in metus eget, eleifend\nlaoreet nibh. Aenean feugiat lectus ut nisl eleifend gravida."
    },
    "sender_service_id": "01BX9NSMKVXXS5PSP2FATZM6QX"
  },
  "notification": {
    "email": "QUEUED"
  }
}

message

id

Descrizione	Identificativo del messaggio ottenuto con la Submit a message
Tipo	Stringa
Esempio	01EM6X4JB9VSZTQ8H16KMQFCEJ

fiscal_code

Descrizione	Codice fiscale del cittadino a cui è stato inviato il messaggio
Tipo	Stringa
Esempio	AAAAAA00A00A000A

created_at

Descrizione	Data di creazione del messaggio nel formato ISO-8601 e fuso orario UTC
Tipo	Stringa
Esempio	2021-02-18T08:17:01.775Z

sender_service_id

Descrizione	Identificativo del servizio associato al messaggio
Tipo	Stringa
Esempio	01EYNQ0864HKYR1Q9PXPJ18W7G

content

I dati relativi al content sono gli stessi inviati tramite il submit del messaggio.

notification

email

Descrizione	Stato d'invio dell'email. - SENT: email inviata correttamente; - THROTTLED: errore temporaneo per sovraccarico, il messaggio potrà essere recapitato entro il TTL e per un massimo di 7 giorni; - EXPIRED: raggiunto il massimo TTL del messaggio; - FAILED: errore permanente della notifica.
Tipo	Stringa
Esempio	SENT

webhook

Descrizione	Stato d'invio della notifica push. - SENT: notifica inviata; - THROTTLED: errore temporaneo per sovraccarico, il messaggio potrà essere recapitato entro il TTL e per un massimo di 7 giorni; - EXPIRED: raggiunto il massimo TTL del messaggio; - FAILED: errore permanente della notifica.
Tipo	Stringa
Esempio	SENT

status

Descrizione	Stato d'invio del messaggio. - ACCEPTED: il messaggio è stato inserito in coda per il salvataggio; - THROTTLED: errore temporaneo per sovraccarico, il messaggio potrà essere recapitato entro il TTL e per un massimo di 7 giorni; - FAILED: errore permanente nel salvataggio del messaggio; - PROCESSED: il messaggio è stato inviato; - REJECTED: il messaggio è stato scartato perché il destinatario non esiste o ha bloccato le comunicazioni del servizio.
Tipo	Stringa
Esempio	PROCESSED

Esempi

Esempio: “PROCESSED”

### REQUEST
curl --location --request GET 'https://api.io.pagopa.it/api/v1/messages/AAAAAA00A00A000A/01EM6X4JB9VSZTQ8H16KMQFCEJ' \
--header 'Ocp-Apim-Subscription-Key: __YOUR_API_KEY__'

### RESPONSE
{
"message": {
"content": {
"subject": "My first IO app message with min 10 character",
"markdown": "This is my first message to the IO app. Use body markdown format with min 80 character"
},
"created_at": "2021-02-18T08:17:01.775Z",
"fiscal_code": "AAAAAA00A00A000A",
"id": "01EM6X4JB9VSZTQ8H16KMQFCEJ",
"sender_service_id": "01EYNQ0864HKYR1Q9PXPJ18W7G"
},
"notification": {
"email": "SENT",
"webhook": "SENT"
},
"status": "PROCESSED"
}

Risorse utili

https://developer.io.italia.it/openapi.html#operation/getMessage