Disbursements Status

This endpoint is used to check the status of a disbursement request by its reference ID.

Endpoint

GET https://api.lipila.dev/api/v1/disbursements/check-status

Query Parameters

The following query parameter is accepted.

Parameter	Type	Description	Required
referenceId	string	Unique reference identifier of the disbursement transaction	Yes

Headers

The following header is accepted.

Header	Type	Description	Required
accept	application/json	Expected response format	Yes

Example Request

cURL

curl -X 'GET' \
  'https://api.lipila.dev/api/v1/disbursements/check-status?referenceId=6e807106-3803-4908-8cd4-c79d0b107404' \
  -H 'accept: application/json' \
  -H 'x-api-key: your_secret_key'

Python

import requests

url = "https://api.lipila.dev/api/v1/disbursements/check-status"

headers = {
    "accept": "application/json",
    "x-api-key": "your_secret_key"
}

params = {
    "referenceId": "6e807106-3803-4908-8cd4-c79d0b107404"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

C#

using System.Net.Http;

var client = new HttpClient();

client.DefaultRequestHeaders.Add("accept", "application/json");
client.DefaultRequestHeaders.Add("x-api-key", "your_secret_key");

var response = await client.GetAsync(
    "https://api.lipila.dev/api/v1/disbursements/check-status?referenceId=6e807106-3803-4908-8cd4-c79d0b107404"
);

Console.WriteLine(await response.Content.ReadAsStringAsync());

Node.js

const params = new URLSearchParams({
  referenceId: "6e807106-3803-4908-8cd4-c79d0b107404",
});

const response = await fetch(
  `https://api.lipila.dev/api/v1/disbursements/check-status?${params}`,
  {
    method: "GET",
    headers: {
      accept: "application/json",
      "x-api-key": "your_secret_key",
    },
  },
);

const data = await response.json();
console.log(data);

PHP

<?php

$url = "https://api.lipila.dev/api/v1/disbursements/check-status?" . http_build_query([
    "referenceId" => "6e807106-3803-4908-8cd4-c79d0b107404"
]);

$headers = [
    "accept: application/json",
    "x-api-key: your_secret_key"
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPGET, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Example Successful Response

Below is an example successful response.

HTTP Status Code	Description
200	Status check Successful

{
  "referenceId": "046b3b664c35",
  "currency": "ZMW",
  "amount": 0.2,
  "accountNumber": "260xxxxxxxxxx",
  "status": "Successful",
  "paymentType": "ZamtelKwacha",
  "type": "Disbursement",
  "ipAddress": "::1",
  "identifier": "LPLTXNDZK-20250819104104-EF4D8905AAC1",
  "externalId": "MP251003.1252.C0324",
  "message": "Process service request successfully."
}

Error Codes

HTTP Status Code	Error Code	Description
400	BAD REQUEST	Missing or invalid request parameters
401	UNAUTHORIZED	Missing or invalid API authentication
403	FORBIDDEN	Access denied to this resource
429	TOO MANY REQUESTS	Rate limit exceeded, slow down requests