MHHS DIP Integration API

API Documentation & Integration Guide

Overview

This endpoint is used to receive JSON payloads from external DIP systems and return a standard acknowledgement response.

The received payload is logged, stored, processed and acknowledged with a unique transaction identifier.

Endpoint Information
POST https://mhhsapi.pozitivehub.com/api/MHHSEndPoints/GetResponse

Property Value
HTTP Method POST
Content Type application/json
Authentication As Configured
Response Format JSON
Request Example

The API accepts JSON payloads from external systems.

[
  {
    "payload": {
      "...": "Incoming Data"
    }
  }
]
Processing Flow
1. Receive JSON Request
2. Log Request Information
3. Store Payload in Database
4. Process Business Data
5. Generate Transaction ID
6. Return Acknowledgement Response
Success Response
{
  "messageArray": [
    {
      "transactionID": "T-IF-023-1996000007-LSS-20260601-639159287638761597",
      "senderUniqueReference": "S-IF-023-1996000007-LSS-20260320-749921588c5ac33f",
      "correlationID": null,
      "sentTimestamp": "2026-03-20T13:30:33+05:30",
      "senderID": "2300000187",
      "recipientID": "1996000007",
      "DIPConnectionProviderID": null,
      "message": "MSG0000:Success",
      "help": null,
      "serviceTicketURL": null
    }
  ],
  "timestamp": "2026-06-01T11:09:34+00:00"
}
Response Field Definitions
Field Description
transactionID System generated unique transaction identifier.
senderUniqueReference Reference received from sender.
correlationID Correlation reference if available.
sentTimestamp Timestamp received from sender.
senderID Receiver system identifier.
recipientID Sender identifier.
DIPConnectionProviderID Connection provider identifier.
message Processing result message.
help Additional support information.
serviceTicketURL Support ticket URL if available.
timestamp Response generation timestamp (UTC).
Status Codes
Status Code Description
201 Created Request processed successfully.
500 Internal Server Error Unexpected server error.
Success Message
MSG0000:Success