Skip to main content

POST /notifications/v1/{mpid}/respond/{notification_id}

Marks a notification as responded to and returns the updated record.

Request​

Method and path:

  • POST /notifications/v1/{mpid}/respond/948a9974-b8c9-4f4d-bef1-70c1b8b30a78

Headers:

  • X-API-KEY (required): string, API key used for tenant authorization.

Path parameters:

  • mpid (required): string supplier MPID.
  • notification_id (required): UUID notification identifier.

Request body:

  • None.

Response​

Success:

  • 200 OK
  • Body type: NotificationResponse
{
  "id": "948a9974-b8c9-4f4d-bef1-70c1b8b30a78",
  "mpan_core": 1234567890123,
  "received_on": "2026-03-20T08:15:00+00:00",
  "notification_type": "RejectedConsumption",
  "detail": {
    "issuing_data_service_dip_id": "DIP-DC-001",
    "connection_type": "H",
    "connection_type_efd": "2026-01-01T00:00:00+00:00",
    "mqid": "AI"
  },
  "completed": true,
  "completed_on": "2026-03-20T08:21:00+00:00"
}

Not found case:

  • 404 when the notification does not exist or does not belong to the supplier.

Full field definitions: