Skip to main content
WEBHOOK
tariffEvent
{
  "webhook_id": "550e8400-e29b-41d4-a716-446655440000",
  "webhook_timestamp": "2026-11-15T09:00:00.000Z",
  "type": "tariff.update",
  "event_timestamp": "2026-11-15T09:00:00.000Z",
  "mpxn": "1012345678901",
  "tariff_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "supplier_mpid": "SEBD"
}

Body

application/json

Payload pushed to an RTI User's webhook when a tariff or consent event occurs. Verify the webhook-signature HTTP header before processing.

​
webhook_id
string<uuid>
required

UUID uniquely identifying a registered webhook endpoint.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
webhook_timestamp
string<date-time>
required

When this notification was dispatched by the supplier.

Example:

"2026-11-01T10:00:00.000Z"

​
type
enum<string>
required

The category of event being notified.

Available options:
tariff.change,
tariff.update,
supplier.change,
consent.revoked,
supplier.cessation
​
event_timestamp
string<date-time>
required

When the underlying event occurred.

Example:

"2026-11-01T10:00:00.000Z"

​
mpxn
string

Meter Point Administration Number (MPAN) or Meter Point Reference Number (MPRN).

Maximum string length: 13
Example:

"1012345678901"

​
tariff_id
string<uuid>

Compact UUID generated by the supplier uniquely identifying a set of tariff pricing data prefixed with trf_. A single display name may map to multiple tariff IDs where a supplier prices differently by payment method or region.

Pattern: ^trf_[0-9a-f]{32}$
Example:

"trf_a1b2c3d4e5f67890abcdef1234567890"

​
supplier_mpid
string

Four-character Market Participant Identifier for a supplier.

Required string length: 4
Example:

"SEBD"

Response

Event received and acknowledged.

Last modified on March 28, 2026