Skip to main content

Disconnection Schema Reference

Headers and Parameters

FieldLocationRequiredTypeFormat / Constraints
X-API-KEYHeaderYesstringUUID format
X-IDEMPOTENCY-KEYHeaderYesstringNon-empty string
X-TEST-MODEHeaderNostringOptional; "true" enables test mode
mpidPathYesstringSupplier MPID

Request Schema

FieldRequiredTypeFormat / Constraints
mpan_coreYesintegerExactly 13 digits, numeric
disconnection_typeYesstring(enum)One of A, P, U
additional_informationNostring or nullMax 200 chars
appointment_dateNostring or nullFormat YYYYMMDD; cannot be in the past
earliest_appointment_timeNostring or nullFormat HHMMSS; numeric and valid 24-hour time
latest_appointment_timeNostring or nullFormat HHMMSS; numeric, valid 24-hour time, and must be greater than or equal to earliest_appointment_time when both are supplied

Additional validation notes:

  • Unknown fields are not explicitly rejected on this endpoint.

Response Schema

FieldRequiredTypeFormat / Constraints
request_idYesstringUUID
request_typeYesstringProcess type name
request_statusYesstring(enum)Pending, Success, Failed
descriptionNostring or nullOptional process description
created_atYesstring(datetime)ISO 8601 datetime
last_updated_atYesstring(datetime)ISO 8601 datetime
mpan_coreYesintegerMPAN core