Skip to main content
GET
/
api
/
v1
/
bills
/
reference
/
{reference}
Get bill transaction by reference
curl --request GET \
  --url https://api.dev.monei.cc/api/v1/bills/reference/{reference} \
  --header 'X-API-KEY: <api-key>'
{
  "statusCode": 123,
  "message": "<string>",
  "data": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "deletedDate": "2023-11-07T05:31:56Z",
    "userId": "<string>",
    "reference": "<string>",
    "billerCode": "<string>",
    "itemCode": "<string>",
    "customer": "<string>",
    "amount": 123,
    "type": "AIRTIME",
    "status": "PENDING",
    "providerData": "<string>",
    "txRef": "<string>",
    "billerName": "<string>",
    "validityPeriod": "<string>",
    "metadata": "<string>",
    "token": "<string>",
    "units": "<string>"
  },
  "errors": {}
}

Authorizations

X-API-KEY
string
header
required

Path Parameters

reference
string
required

Unique bill transaction reference

Example:

"BILL-REF-20240115-ABCD1234"

Response

Successfully retrieved bill transaction

statusCode
number
required
message
string
required
data
object
required

Bill payment fetched successfully

errors
object
required