Bills PaymentsAirtimeAirtime Provider

Get Airtime Providers

Get Airtime Providers Endpoint Fetches a list of available airtime providers along with their logos and minimum/maximum amount requirements.

Endpoint

GET https://backendapi.sayswitchgroup.com/api/v1/airtime

Sample cURL Request

curl --request GET \
  --url "https://backendapi.sayswitchgroup.com/api/v1/airtime \
  --header 'Authorization: Bearer YOUR_SECRET_KEY'

Sample Response

{
  "success": true,
  "code": "00000",
  "message": "Fetched successfully",
  "data": [
    {
      "provider": "AIRTEL",
      "providerLogoUrl": "assets/images/bills/Airtel-Airtime.jpg",
      "minAmount": "5",
      "maxAmount": ""
    },
    {
      "provider": "MTN",
      "providerLogoUrl": "assets/images/bills/MTN-Airtime.jpg",
      "minAmount": "5",
      "maxAmount": ""
    },
    {
      "provider": "GLO",
      "providerLogoUrl": "assets/images/bills/GLO-Airtime.jpg",
      "minAmount": "5",
      "maxAmount": ""
    },
    {
      "provider": "9MOBILE",
      "providerLogoUrl": "assets/images/bills/9mobile-Airtime.jpg",
      "minAmount": "5",
      "maxAmount": ""
    }
  ]
}

Response Fields

FieldTypeDescription
successbooleanIndicates if the request was successful
codestringAPI-specific response code
messagestringDescription message
dataarrayList of airtime providers
providerstringName of the provider (e.g., MTN, AIRTEL)
providerLogoUrlstringPath to the provider’s logo image
minAmountstringMinimum allowable purchase amount
maxAmountstringMaximum allowable purchase amount (can be empty)