How to detect ongoing promotions in your country using Reloadly

Raphael Ugwu

July 12, 2022

2 min

Table of Contents

Promotions are a great way to derive value for every top-up you make. Certain operators carry out periodic promotions every now and then. Examples of promotions carried out by telecom operators include:

Additional free credits for top-ups of a particular value
Additional data bundles for top-ups made during particular public holidays e.g Mother’s day

As a Reloadly user, it would be great to be able to view ongoing promotions for all the operators within your country. This guide will show you how to achieve that.

The steps to be followed in this guide are as follows:

Getting your access token
Getting details of all the promotions within your country

You can get your access token by following the steps in this quickstart.

Getting details of all the promotions within your country

Suppose your country is Ethiopia and you want to find out if there are any ongoing promotions, you can make a request to an endpoint that takes Ethiopia’s two letter ISO code as a parameter and returns a list of ongoing promotions.

The code sample below is written in cURL and shows how to achieve this

curl -i -X GET \
  https://topups-sandbox.reloadly.com/promotions/country-codes/ET \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

If your request is successful, you receive a data object containing information on Ethiopia’s promotions

[
  {
    "id": 5665,
    "promotionId": 5665,
    "operatorId": 130,
    "title": "Ethiotelecom Ethiopia From 01 Mar 2021 00:00 To 30 Jun 2021 23:59 (GMT+03:00)",
    "title2": "Bonus 50%",
    "description": "We are pleased to inform you the 50% IAT promotional bonus for Ethiotelecom is extended for additional four months as per below details.<br /><br /><strong>KEY INFORMATION:</strong><br />Bonus value:<strong> 50%</strong><br />Bonus receivers:<strong> &ge;50 ETB recharge during the promo period</strong><br />Promotion date: <strong>March 01,2021 up to June 30, 2021</strong><br />Bonus validity period:<strong> 15 days<br /><br /><img alt=\"\" src=\"https://i.postimg.cc/g2prm1fL/Picture1-Ethio.png\" style=\"height:245px; width:651px\" /></strong>",
    "startDate": "2021-03-01 02:00:00",
    "endDate": "2021-07-01 00:59:00",
    "denominations": null,
    "localDenominations": "ETB 50 and up"
  },
  {
    "id": 5887,
    "promotionId": 5887,
    "operatorId": 130,
    "title": "Ethiotelecom Ethiopia From 30 Apr 2021 00:01 To 04 May 2021 23:59 (GMT+03:00)",
    "title2": "Flexi Package",
    "description": "To Celebrate&nbsp;<strong>Easter Holiday&nbsp;</strong>in Ethiopia<strong>,</strong>&nbsp;Ethio Telecom has launched a promotional international airtime top up of&nbsp;<strong>flexi package Easter holiday bonus from&nbsp;</strong>April 30th to May 04th. 2021<br /><br /><strong><u>Promoton Details</u></strong><br />* Bonus is valid for 5 Days (usable).<br />* IAT receivers shall receive 50 Br. &ge; recharge during incentive period<br />Flexi package details:<br />o&nbsp;&nbsp;&nbsp;50Br &ge;&nbsp;Receiver received value &lt; 100Br:&nbsp;<strong>1,340</strong>&nbsp;flexi unit bonus<br />o&nbsp;&nbsp;&nbsp;100Br &le; Receiver received value &lt; 200Br:&nbsp;<strong>3,416</strong>&nbsp;flexi unit bonus<br />o&nbsp;&nbsp;&nbsp;Receiver received value &ge; 200:&nbsp;<strong>8,429</strong>&nbsp;flexi unit bonus<br />o&nbsp;&nbsp;&nbsp;<strong><em>1 Minute = 6 Flexi, 1 SMS = 2 Flexi, 1 MB = 2 Flexi</em></strong>",
    "startDate": "2021-04-30 01:01:00",
    "endDate": "2021-05-05 00:59:00",
    "denominations": "Bir 50 and abpve",
    "localDenominations": "Bir 50 and Above"
  },
  {
    "id": 5903,
    "promotionId": 5903,
    "operatorId": 130,
    "title": "Ethiotelecom Ethiopia From 05 May 2021 00:00 To 30 Jun 2021 23:59 (GMT+03:00)",
    "title2": "Bonus 50%",
    "description": "We are pleased to inform you the 50% IAT promotional bonus for Ethiotelecom is extended for additional four months as per below details.<br /><br /><strong>KEY INFORMATION:</strong><br />Bonus value:<strong> 50%</strong><br />Bonus receivers:<strong> &ge;50 ETB recharge during the promo period</strong><br />Promotion date: <strong>March 01,2021 up to June 30, 2021, except April 30 - May 4th, 2021</strong><br />Bonus validity period:<strong> 15 days<br /><br /><img alt=\"\" src=\"https://i.postimg.cc/g2prm1fL/Picture1-Ethio.png\" style=\"height:245px; width:651px\" /></strong>",
    "startDate": "2021-05-05 01:00:00",
    "endDate": "2021-07-01 00:59:00",
    "denominations": null,
    "localDenominations": "ETB 50 and up"
  }
]