Notifications inform the ServiceProvider about events or conditions that may affect the Sharing Flow, such as:

Missing value for a claim (for technical or functional reasons)
Use of a deprecated claim in the requested scope
Other process-related information

Notifications are process-level metadata: they never contain personal data and do not modify the content of user_info or post_processed.

It is recommended to at least log these notifications for means of support.

Notifications are activated by default, but may be deactivated upon request by contacting MiTrust support.

Location in the API response

In the final API response, notifications appears as a sibling of user_info (and post_processed when present), inside the data object:

{
  "data": {
    "user_info": {
      "...": "raw claim values from data providers"
    },
    "post_processed": {
      "...": "optional normalized or enriched fields"
    },
    "notifications": [
      {
        "type": "deprecated_claim",
        "message": "Deprecated claim used in scope parameter, please update your configuration",
        "deprecated_claim": "tax.income_tax_return",
        "future_claim": "tax.income.tax_return"
      }
    ]
  },
  "status": "success"
}

If there is no notification, the notifications field may be omitted.

Notification Structure

A notification entry may include the following fields:

Field	Description
`type`	Category of notification (e.g., `missing_data`, `deprecated_claim`)
`subtype`	Optional refinement of `type`, e.g. `missing_claim`
`message`	Human-readable explanation
Additional context fields	Vary depending on the notification type (`code`, `details`, `claim_hint`, `future_claim`, etc.)

Example — Missing claim due to technical unavailability

"notifications": [
  {
    "type": "missing_data",
    "subtype": "missing_claim",
    "message": "The tax notice could not be retrieved due to a temporary data-provider unavailability.",
    "claim_hint": "tax.income.tax_notice",
    "code": "data_source_unavailable",
    "details": "Impots.gouv returned a transient technical error (#documentsindisponibles)."
  }
]