Get a Bill Payment Status

Fetch the status of a bill purchase

GET /bills/{reference}

Get a Bill Payment Status

cURL

curl --request GET \
  --url https://api.flutterwave.com/v3/bills/{reference} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>'

200

{
  "status": "success",
  "message": "Bill status fetch successful",
  "data": {
    "currency": "NGN",
    "customer_id": "0025401100",
    "frequency": "One Time",
    "amount": "1800.00",
    "fee": 100,
    "product": "DSTV Payment",
    "product_name": "DSTV Payment",
    "commission": 10,
    "transaction_date": "2024-03-24T09:14:13.373Z",
    "customer_reference": "d7a004b1-a581-4cd9-89ae-a1f093400",
    "country": "NG",
    "flw_ref": "247837898415",
    "tx_ref": "CF-FLYAPI-20240324091413750321",
    "batch_id": 3408739,
    "extra": null,
    "product_details": "FLY-API-NG-DSTV Payment"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Content-Type · enum<string> · required

Available options: application/json

Example:

"application/json"

Path Parameters

reference · string · required

Example:

"CF-FLYAPI-20240324091413750321"

Query Parameters

verbose · integer<int32> · required

Example:

1

Response

200

application/json; charset=utf-8

OK

status · string · required

message · string · required

data · Data76 · object · required

Show child attributes

Example:

{
  "currency": "NGN",
  "customer_id": "0025401100",
  "frequency": "One Time",
  "amount": "1800.00",
  "fee": 100,
  "product": "DSTV Payment",
  "product_name": "DSTV Payment",
  "commission": 10,
  "transaction_date": "2024-03-24T09:14:13.373Z",
  "customer_reference": "d7a004b1-a581-4cd9-89ae-a1f093400",
  "country": "NG",
  "flw_ref": "247837898415",
  "tx_ref": "CF-FLYAPI-20240324091413750321",
  "batch_id": 3408739,
  "extra": null,
  "product_details": "FLY-API-NG-DSTV Payment"
}