Collections Status

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

Endpoint

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

Query Parameters

The following query parameter is accepted.

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

Headers

The following header is accepted.

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

Example Request

curl -X 'GET' \
  'https://api.lipila.dev/api/v1/collections/check-status?referenceId=8017bfe9-d62b-4abb-b711-1690792e6efe' \
  -H 'accept: application/json' \
  -H 'x-api-key: your_secret_key'

Example Successful Response

Below is an example successful response.

HTTP Status Code	Description
200	SUCCESS

{
  "referenceId": "fca597ea2da6",
  "currency": "ZMW",
  "amount": 1,
  "accountNumber": "260xxxxxxxxxx",
  "status": "Successful",
  "paymentType": "AirtelMoney",
  "type": "Collection",
  "ipAddress": "::1",
  "identifier": "LPLTXNCAM-20250818145713-B4AB61CD8A8F",
  "externalId": "MP251003.1252.C7324",
  "message": "Transaction Successful"
}

Error Codes

HTTP Status Code	Error Code	Description
400	BAD REQUEST	Missing or invalid query parameters
404	NOT FOUND	Collection with the given referenceId not found
429	TOO MANY REQUESTS	Rate limit exceeded, slow down requests