API Documentation & Integration Guide
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.
| Property | Value |
|---|---|
| HTTP Method | POST |
| Content Type | application/json |
| Authentication | As Configured |
| Response Format | JSON |
The API accepts JSON payloads from external systems.
[
{
"payload": {
"...": "Incoming Data"
}
}
]
{
"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"
}
| 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 Code | Description |
|---|---|
| 201 Created | Request processed successfully. |
| 500 Internal Server Error | Unexpected server error. |