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

{
  "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
}

{
  "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":[
    
  ]
}

Request samples

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'

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);
    }

  }
}

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))
}

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();

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

$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;

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

PreviousFetch FX Rate by operator ID NextGet commissions by operator ID

Last updated 4 years ago

hashtagCommissions

hashtagQuery Parameters

hashtagHeaders

hashtag

hashtagRequest samples

hashtag

hashtagResponse Parameters

Commissions

Query Parameters

Headers

Request samples

Response Parameters