Articles on: Getting Started

Getting Started with the Diool API | Transaction Status Endpoint

The general details about the Diool's RESTful API and the prerequisites to use or test this endpoint with Postman can be found on the introductory article: Getting Started with the Diool API | Introduction.

The status endpoint executes a request to get the status of a particular transaction (payment, transfer, etc.).

It accepts only one additional parameter, which is the uniqueReference of the transaction.

Request Parameter for the Transaction Status Endpoint


Sample Request

# Here is a curl example
  curl -d 
 '{ "uniqueReference": "HAUNMYVD" }'
  -H "Authorization: Bearer [API-KEY]"
  -H "Content-Type: application/json"

Transaction Status Endpoint - Sample Request

Sample Response - Prod

    "code": 0,
    "message": "Operation Successful",
    "developerMessage": "Operation Successful",
    "moreInfo": "",
    "resultType": "SUCCESS",
    "result": {
        "statusCode": 11,
        "statusDescription": "The sender does not have enough credit to perform this transfer",
        "timeStamp": "1692627147105"

Need Help?

Already using or testing the API and need a hand?

Self service: Check out the FAQ.
Have a question..? Chat with us instantly through the Live Chat on our Help Center.
Totally stuck..? Send us a mail at and we will get back to you as soon as possible.

Updated on: 23/08/2023

Was this article helpful?

Share your feedback


Thank you!