Get all commissions

With the /operators/commissions endpoint, developers can get a list of all operators who are running active discounts on top-ups

Commissions

GET https://topups.reloadly.com/operators/commissions

Query Parameters

Name	Type	Description
size	integer	The number of operators offering discounts to be retrieved on a page. Default value is 200
page	integer	The page of the list of operators offering discounts. Default value is 1

Headers

Name	Type	Description
Authorization*	string	Your access token is required as a bearer token in the request's header

200 This response is gotten when a successful request is made and a list of operators with active discounts is returned

JSON

{
  "content":[
    {
      "operator":{
        "operatorId":1,
        "name":"Afghan Wireless Afghanistan",
        "countryCode":"AF",
        "status":true,
        "bundle":false
      },
      "percentage":10,
      "internationalPercentage":10,
      "localPercentage":0,
      "updatedAt":"2018-06-26 03:36:16"
    },
    {
      "operator":{
        "operatorId":2,
        "name":"MTN Afghanistan",
        "countryCode":"AF",
        "status":true,
        "bundle":false
      },
      "percentage":10,
      "internationalPercentage":10,
      "localPercentage":0,
      "updatedAt":"2018-06-26 03:36:16"
    },
    {
      "operator":{
        "operatorId":3,
        "name":"Etisalat Afghanistan",
        "countryCode":"AF",
        "status":true,
        "bundle":false
      },
      "percentage":10,
      "internationalPercentage":10,
      "localPercentage":0,
      "updatedAt":"2018-06-26 03:36:16"
    }
  ],
  "pageable":{
    "sort":{
      "unsorted":true,
      "sorted":false
    },
    "pageSize":3,
    "pageNumber":0,
    "offset":0,
    "paged":true,
    "unpaged":false
  },
  "totalPages":204,
  "totalElements":611,
  "last":false,
  "sort":{
    "unsorted":true,
    "sorted":false
  },
  "first":true,
  "numberOfElements":3,
  "size":3,
  "number":0
}

401 This response is gotten when a request is made with an incorrect or expired access token

JSON

{
  "timeStamp":"2021-06-09 23:24:30",
  "message":"Full authentication is required to access this resource",
  "path":"/operators/commissions",
  "errorCode":"INVALID_TOKEN",
  "infoLink":null,
  "details":[
    
  ]
}

404 This response is gotten when a request is made to an incorrect URL path

JSON

{
  "timestamp":"2021-06-09T23:22:56.125+0000",
  "status":404,
  "error":"Not Found",
  "message":"No message available",
  "path":"/operator/commissions"
}

Request samples

cURL

curl --location --request GET 'https://topups.reloadly.com/operators/commissions' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN_HERE' \
--header 'Accept: application/com.reloadly.topups-v1+json' 

C#

using System;
using System.Threading.Tasks;
using System.Net.Http;
using System.Text;
using Newtonsoft.Json;

namespace WebAPIClient {
  class Program {

    static async Task Main(string[] args) {
      await ApiCall();
    }

    private static async Task ApiCall() {

      var message = new HttpRequestMessage(HttpMethod.Get, "https://topups.reloadly.com/operators/commissions");

      message.Headers.TryAddWithoutValidation("Authorization", "Bearer YOUR_ACCESS_TOKEN_HERE");
      message.Headers.TryAddWithoutValidation("Accept", "application/com.reloadly.topups-v1+json");

      using
      var httpClient = new HttpClient();
      var response = await httpClient.SendAsync(message);
      var responseBody = await response.Content.ReadAsStringAsync();
      var result = JsonConvert.DeserializeObject < dynamic > (responseBody);

      Console.WriteLine(result);
    }

  }
}

Golang

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://topups.reloadly.com/operators/commissions"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN_HERE")
  req.Header.Add("Accept", "application/com.reloadly.topups-v1+json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://topups.reloadly.com/operators/commissions")
  .method("GET", null)
  .addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN_HERE")
  .addHeader("Accept", "application/com.reloadly.topups-v1+json")
  .build();
Response response = client.newCall(request).execute();

Node JS

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://topups.reloadly.com/operators/commissions',
  'headers': {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN_HERE',
    'Accept': 'application/com.reloadly.topups-v1+json',
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://topups.reloadly.com/operators/commissions',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer YOUR_ACCESS_TOKEN_HERE',
    'Accept: application/com.reloadly.topups-v1+json',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Python

import requests
import json

url = "https://topups.reloadly.com/operators/commissions"

payload={}
headers = {
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN_HERE',
  'Accept': 'application/com.reloadly.topups-v1+json',
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Response Parameters

Parameter	Type	Description
percentage	integer	Indicates the percentage discount for every top-up
international Percentage	integer	Indicates the percentage discount for international top-ups
localPercentage	integer	Indicates the percentage discount for local top-ups
updatedAt	integer	Indicates the time the discount was first created by the operator
operatorId	string	Indicates the operator's ID
name	string	Indicates the operator's name
countryCode	string	Indicates the ISO code of the country where the operator is registered
data	boolean	Indicates if the operator has any existing data discounts
bundle	boolean	Indicates if the operator has any existing bundle discounts
status	boolean	Indicates if the operator has any existing discounts