- MSG)
- Response body: messages.originalMessage.request object
| 2025-08-06 | 11555 v2.0 |
| Add enum values "G", "M", "B", "H", "O" | Early adopter | Added enum values "G", "M", "B", "H", "O" to "antiToxoplasmosisStatus" and "antiEbvStatus" fields within idm object in TYP_RES, IDM_RES, RSV_RES, SMP_RES endpoints. G = IgG positive, IgM negative; M = IgG negative, IgM positive; B = Both IgG and IgM positive; H = IgG positive, IgM not tested; O = IgG negative, IgM not tested. Affected payloads: - /api/v2/extendedTypingResponseRequest (TYP_RES)
- Request body: donor.idm object
- /api/v2/extendedTypingResponseRetrieve (TYP_RES)
- Response body: messages.originalMessage.donor.idm object
- /api/v2/infectiousDiseaseMarkerResultRequest (IDM_RES)
- Request body: response.idm & donor.idm objects
- /api/v2/infectiousDiseaseMarkerResultRetrieve (IDM_RES)
- Response body: messages.originalMessage.response.idm & messages.originalMessage.donor.idm objects
- /api/v2/reservationResponseRequest (RSV_RES)
- Request body: donor.idm object
- /api/v2/reservationResponseRetrieve (RSV_RES)
- Response body: messages.originalMessage.donor.idm object
- /api/v2/sampleResponseRequest (SMP_RES)
- Request body: response.idm object
- /api/v2/sampleResponseRetrieve (SMP_RES)
- Response body: messages.originalMessage.responce.idm object
| 2025-08-08 | 13032 v2.0 |
| Rename "donorCcr5Status" to "ccr5" and added "abo", " rhesus" fields | TWG | Renamed "donorCcr5Status" to "ccr5" and added "abo", " rhesus" fields to response object in IDM_RES endpoints. Affected payloads: - /api/v2/infectiousDiseaseMarkerResultRequest (IDM_RES)
- Request body: response object
- /api/v2/infectiousDiseaseMarkerResultRetrieve (IDM_RES)
- Response body: messages.originalMessage.response object
& Added "ccr5" field to response object in SMP_RES endpoints. Affected payloads: - /api/v2/sampleResponseRequest (SMP_RES)
- Request body: response object
- /api/v2/sampleResponseRetrieve (SMP_RES)
- Response body: messages.originalMessage.response object
| 2025-08-08 | 12353 v2.0 |
| Remove "mixedLymphocyteCultureGvh", "mixedLymphocyteCultureHvg", "gvhReactivityPercent", "hvgReactivityPercent", "other" fields & move these fields within SMP_RES endpoints | Early adopter | Removed "mixedLymphocyteCultureGvh", "mixedLymphocyteCultureHvg", "gvhReactivityPercent", "hvgReactivityPercent", "other" ("other" field present in the marker object only) fields from TYP_RES, IDM_REQ, IDM_RES, RSV_RES endpoints. Affected payloads: - /api/v2/extendedTypingResponseRequest (TYP_RES)
- Request body: donor.idm object
- /api/v2/extendedTypingResponseRetrieve (TYP_RES)
- Response body: messages.originalMessage.donor.idm object
- /api/v2/infectiousDiseaseMarkerRequestRequest (IDM_REQ)
- Request body: request.marker object
- /api/v2/infectiousDiseaseMarkerRequestRetrieve (IDM_REQ)
- Response body: messages.originalMessage.request.marker object
- /api/v2/infectiousDiseaseMarkerResultRequest (IDM_RES)
- Request body: response.marker, response.idm & donor.idm objects
- /api/v2/infectiousDiseaseMarkerResultRetrieve (IDM_RES)
- Response body: messages.originalMessage.response.marker, messages.originalMessage.response.idm & messages.originalMessage.donor.idm objects
- /api/v2/reservationResponseRequest (RSV_RES)
- Request body: donor.idm object
- /api/v2/reservationResponseRetrieve (RSV_RES)
- Response body: messages.originalMessage.donor.idm object
& Moved "mixedLymphocyteCultureGvh", "mixedLymphocyteCultureHvg", "gvhReactivityPercent", "hvgReactivityPercent" fields from response.idm to a new object response.lymphocyteReactivity in SMP_RES endpoints. Affected payloads: - /api/v2/sampleResponseRequest (SMP_RES)
- Request body: response.idm → response.lymphocyteReactivity object
- /api/v2/sampleResponseRetrieve (SMP_RES)
- Response body: messages.originalMessage.response.idm → messages.originalMessage.response.lymphocyteReactivity object
| 2025-08-07 | 12465 v2.0 |
Add optional field reservedPatientWmdaId | TWG | Added optional field reservedPatientWmdaId to the Donor In Response block in TYP_RES, IDM_RES, RSV_RES endpoints. Affected payloads: - /api/v2/extendedTypingResponseRequest (TYP_RES)
- Request body: donor object
- /api/v2/extendedTypingResponseRetrieve (TYP_RES)
- Response body: messages.originalMessage.donor object
- /api/v2/infectiousDiseaseMarkerResultRequest (IDM_RES)
- Request body: donor object
- /api/v2/infectiousDiseaseMarkerResultRetrieve (IDM_RES)
- Response body: messages.originalMessage.donor object
- /api/v2/reservationResponseRequest (RSV_RES)
- Request body: donor object
- /api/v2/reservationResponseRetrieve (RSV_RES)
- Response body: messages.originalMessage.donor object
| 2025-08-28 | 12354 v2.0 |
| Add hla object with optional fields | TWG | Added required object hla with optional fields to response object in TYP_RES endpoints. Affected payloads: - /api/v2/extendedTypingResponseRequest (TYP_RES)
- Request body: response → response.hla object
- /api/v2/extendedTypingResponseRetrieve (TYP_RES)
- Response body: messages.originalMessage.response → messages.originalMessage.response.hla object
| 2025-08-29 | 11587 v2.0 |
| Add value 'Q' as enum | TWG | Added enum value "Q" (Questionable) to the fields (antiCmvStatus, cmvNatStatus, hepatitisBSurfaceAntigenStatus, antiHepatitisBCoreStatus, antiHepatitisBSurfaceAntigenStatus, hepatitisBNatStatus, antiHepatitisCStatus, hepatitisCNatStatus, antiHepatitisEStatus, hepatitisENatStatus, antiHiv12Status, hiv1NatStatus, hivP24Status, antiHtlvStatus, syphilisStatus, westNileVirusNatStatus, chagasNatStatus, antiEbvStatus, antiToxoplasmosisStatus, parvoB19NatStatus) within idm object in TYP_RES, IDM_RES, RSV_RES, SMP_RES endpoints Affected payloads: - /api/v2/extendedTypingResponseRequest (TYP_RES)
- Request body: donor.idm object
- /api/v2/extendedTypingResponseRetrieve (TYP_RES)
- Response body: messages.originalMessage.donor.idm object
- /api/v2/infectiousDiseaseMarkerResultRequest (IDM_RES)
- Request body: donor.idm & response.idm objects
- /api/v2/infectiousDiseaseMarkerResultRetrieve (IDM_RES)
- Response body: messages.originalMessage.donor.idm & messages.originalMessage.response.idm objects
- /api/v2/reservationResponseRequest (RSV_RES)
- Request body: donor.idm object
- /api/v2/reservationResponseRetrieve (RSV_RES)
- Response body: messages.originalMessage.donor.idm object
- /api/v2/sampleResponseRequest (SMP_RES)
- Request body: response.idm object
- /api/v2/sampleResponseRetrieve (SMP_RES)
- Response body: messages.originalMessage.response & messages.originalMessage.response.idm objects
| 2025-09-09 | 12464 v2.0 |
Refine organisation & sampleType
| TWG | Added optional fields "phone", "fax", "email" to organisation object in TYP_RES, IDM_REQ, SMP_REQ endpoints. Affected payloads: - /api/v2/extendedTypingRequestRequest (TYP_REQ)
- Request body: request.institutionPaying.organisation object
- /api/v2/extendedTypingRequestRetrieve (TYP_REQ)
- Response body: messages.originalMessage.request.institutionPaying.organisation object
- /api/v2/infectiousDiseaseMarkerRequestRequest (IDM_REQ)
- Request body: request.institutionPaying.organisation object
- /api/v2/infectiousDiseaseMarkerRequestRetrieve (IDM_REQ)
- Response body: messages.originalMessage.request.institutionPaying.organisation object
- /api/v2/sampleRequestRequest (SMP_REQ)
- Request body: request.institutionPaying.organisation object
- /api/v2/sampleRequestRetrieve (SMP_REQ)
- Response body: messages.originalMessage.request.institutionPaying.organisation object
& Renamed "ctSampleType" field to "sampleType" in TYP_REQ, SMP_ARR endpoints. Affected payloads: - /api/v2/extendedTypingResponseRequest (TYP_RES)
- Request body: response object
- /api/v2/extendedTypingResponseRetrieve (TYP_RES)
- Response body: messages.originalMessage.response object
- /api/v2/sampleArrivalRequest (SMP_ARR)
- Request body: message object
- /api/v2/sampleArrivalRetrieve (SMP_ARR)
- Response body: messages.originalMessage.message object
| 2025-09-16 | 10835 v2.0 |
| endpoint: /upload Attachment | MC-RFC 03: Document Exchange | Endpoint to upload a file to blob storage. | 2025-10-01 | 13195 v2.1 |
| endpoint: /download Attachment | MC-RFC 03: Document Exchange | Endpoint to download a file from blob storage. | 2025-10-01 | 13289 v2.1 |
| Add Serology object with two fields to hla.a, hla.b, hla.c, hla.drb1, hla.dqb1 | TWG | Added optional serology object with two fields to hla.a, hla.b, hla.c, hla.drb1, hla.dqb1 withing hla object for TYP_RES, IDM_RES, RSV_RES, SMP_RES, TYP_REQ, Generic Request, IDM_REQ, RSV_REQ, SMP_REQ, Update Registered Patient endpoints. Affected payloads: - /api/v2/extendedTypingResponseRequest (TYP_RES)
- Request body: donor.hla.a, donor.hla.b, donor.hla.c, donor.hla.drb1, donor.hla.dqb1 & response.hla.a, response.hla.b, response.hla.c, reponse.hla.drb1, response.hla.dqb1 objects
- /api/v2/extendedTypingResponseRetrieve (TYP_RES)
- Response body: messages.originalMessage.donor.hla.a, messages.originalMessage.donor.hla.b, messages.originalMessage.donor.hla.c, messages.originalMessage.donor.hla.drb1, messages.originalMessage.donor.hla.dqb1 & messages.originalMessage.response.hla.a, messages.originalMessage.response.hla.b, messages.originalMessage.response.hla.c, messages.originalMessage.response.hla.drb1, messages.originalMessage.response.hla.dqb1 objects
- /api/v2/infectiousDiseaseMarkerResultRequest (IDM_RES)
- Request body: donor.hla.a, donor.hla.b, donor.hla.c, donor.hla.drb1, donor.hla.dqb1 objects
- /api/v2/infectiousDiseaseMarkerResultRetrieve (IDM_RES)
- Response body: messages.originalMessage.donor.hla.a, messages.originalMessage.donor.hla.b, messages.originalMessage.donor.hla.c, messages.originalMessage.donor.hla.drb1, messages.originalMessage.donor.hla.dqb1 objects
- /api/v2/reservationResponseRequest (RSV_RES)
- Request body: donor.hla.a, donor.hla.b, donor.hla.c, donor.hla.drb1, donor.hla.dqb1 objects
- /api/v2/reservationResponseRetrieve (RSV_RES)
- Response body: messages.originalMessage.donor.hla.a, messages.originalMessage.donor.hla.b, messages.originalMessage.donor.hla.c, messages.originalMessage.donor.hla.drb1, messages.originalMessage.donor.hla.dqb1 objects
- /api/v2/sampleResponseRequest (SMP_RES)
- Request body: response.hla.a, response.hla.b, response.hla.c, reponse.hla.drb1, response.hla.dqb1 objects
- /api/v2/sampleResponseRetrieve (SMP_RES)
- Response body: messages.originalMessage.response.hla.a, messages.originalMessage.response.hla.b, messages.originalMessage.response.hla.c, messages.originalMessage.response.hla.drb1, messages.originalMessage.response.hla.dqb1 objects
- /api/v2/extendedTypingRequestRequest (TYP_REQ)
- Request body: patient.hla.a, patient.hla.b, patient.hla.c, patient.hla.drb1, patient.hla.dqb1 objects
- /api/v2/extendedTypingRequestRetrieve (TYP_REQ)
- Response body: messages.originalMessage.patient.hla.a, messages.originalMessage.patient.hla.b, messages.originalMessage.patient.hla.c, messages.originalMessage.patient.hla.drb1, messages.originalMessage.patient.hla.dqb1 objects
- /api/v2/GenericRequestRequest
- Request body: patient.hla.a, patient.hla.b, patient.hla.c, patient.hla.drb1, patient.hla.dqb1 objects
- /api/v2/GenericRequestRetrieve
- Response body: messages.originalMessage.patient.hla.a, messages.originalMessage.patient.hla.b, messages.originalMessage.patient.hla.c, messages.originalMessage.patient.hla.drb1, messages.originalMessage.patient.hla.dqb1 objects
- /api/v2/infectiousDiseaseMarkerRequestRequest (IDM_REQ)
- Request body: patient.hla.a, patient.hla.b, patient.hla.c, patient.hla.drb1, patient.hla.dqb1 objects
- /api/v2/infectiousDiseaseMarkerRequestRetrieve (IDM_REQ)
- Response body: messages.originalMessage.patient.hla.a, messages.originalMessage.patient.hla.b, messages.originalMessage.patient.hla.c, messages.originalMessage.patient.hla.drb1, messages.originalMessage.patient.hla.dqb1 objects
- /api/v2/reservationRequestRequest (RSV_REQ)
- Request body: patient.hla.a, patient.hla.b, patient.hla.c, patient.hla.drb1, patient.hla.dqb1 objects
- /api/v2/reservationRequestRetrieve (RSV_REQ)
- Response body: messages.originalMessage.patient.hla.a, messages.originalMessage.patient.hla.b, messages.originalMessage.patient.hla.c, messages.originalMessage.patient.hla.drb1, messages.originalMessage.patient.hla.dqb1 objects
- /api/v2/sampleRequestRequest (SMP_REQ)
- Request body: patient.hla.a, patient.hla.b, patient.hla.c, patient.hla.drb1, patient.hla.dqb1 objects
- /api/v2/sampleRequestRetrieve (SMP_REQ)
- Response body: messages.originalMessage.patient.hla.a, messages.originalMessage.patient.hla.b, messages.originalMessage.patient.hla.c, messages.originalMessage.patient.hla.drb1, messages.originalMessage.patient.hla.dqb1 objects
- /api/v2/updateRegisteredPatientRequest
- Request body: patient.hla.a, patient.hla.b, patient.hla.c, patient.hla.drb1, patient.hla.dqb1 objects
- /api/v2/updateRegisteredPatientRetrieve
- Response body: messages.originalMessage.patient.hla.a, messages.originalMessage.patient.hla.b, messages.originalMessage.patient.hla.c, messages.originalMessage.patient.hla.drb1, messages.originalMessage.patient.hla.dqb1 objects
| 2025-10-03 | 10817 v2.0 |
| Add extra logic when confirming reservation | TWG | Soft fail is triggered when confirming Reservation Response (RSV_RES) endpoint without reserving the donor. If "response.confirmed" is TRUE and "donor.status" ≠ RS (reserved), API will respond with a soft fail - 200 OK and include a warning: "responseType": /"warning" "wmdaRemarks": "remarkType": "invalidInformation" "description": "Donor Status must be RS (reserved) when confirming reservation" | 2025-10-07 | 13535 v2.0 |
| Add extra validation for selected fields | WMDA | Added following validations: - "donor.dateOfBirth" field is required and nullable: false. Used in TYP_RES, IDM_RES, RSV_RES endpoints
- "hlaNomenclatureVersion" field has maxLenght: 5. Used in TYP_RES, SMP_RES endpoints
- "organisationId" is required, has minLength: 5, maxLength: 19, and the pattern: ^\\d{4}\\w{1,19}$. Used in institutionPaying object in TYP_REQ. IDM_REQ, SMP_REQ. Also in institutionToSendSampleTo object in SMP_REQ endpoint.
- "donorId" field in Embedded Donor Block (donor in request object) has the following validation in TYP_REQ, genericRequest, IDM_REQ, REQ_CAN, NO_RES, RSV_REQ, reservationRelease, RES_REM, SMP_ARR, SMP_INFO, SMP_REQ, SMP_RES, TXT_MSG endpoints:
- If donorType is adult, then grid must be provided with minLength: 19, maxLength: 19
- If donorType is adcu, then adcuId must be provided with minLength: 13, maxLength: 13
- If donorType is cbu, then cordId must be provided with minLength: 1, maxLength: 17
| 2025-10-09 | 13617 v2.0 |
| Add "antiChagas" field to the marker and idm objects | TWG | Added new optional field "antiChagasStatus" to the marker and idm objects in IDM_REQ (request.marker object), IDM_RES (response.marker , response.idm & donor.idm objects), TYP_RES (donor.idm object), RSV_RES (donor.idm object), SMP_RES (response.idm object) endpoints . Affected payloads: - /api/v2/infectiousDiseaseMarkerRequestRequest (IDM_REQ)
- Request body: request.marker object
- /api/v2/infectiousDiseaseMarkerRequestRetrieve (IDM_REQ)
- Response body: messages.originalMessage.request.marker object
- /api/v2/infectiousDiseaseMarkerResultRequest (IDM_RES)
- Request body: response.marker, response.idm & donor.idm objects
- /api/v2/infectiousDiseaseMarkerResultRetrieve (IDM_RES)
- Response body: messages.originalMessage.response.marker, messages.originalMessage.response.idm & messages.originalMessage.donor.idm objects
- /api/v2/extendedTypingResponseRequest (TYP_RES)
- Request body: donor.idm object
- /api/v2/extendedTypingResponseRetrieve (TYP_RES)
- Response body: messages.originalMessage.donor.idm object
- /api/v2/reservationResponseRequest (RSV_RES)
- Request body: donor.idm object
- /api/v2/reservationResponseRetrieve (RSV_RES)
- Response body: messages.originalMessage.donor.idm object
- /api/v2/sampleResponseRequest (SMP_RES)
- Request body: response.idm object
- /api/v2/sampleResponseRetrieve (SMP_RES)
- Response body: messages.originalMessage.response.idm object
| 2025-10-09 | 13562 v2.0 |
Add "remark" field to the |