Skip to main content
GET
/
api
/
v1
/
general
/
bin
Check Available Data Plans
curl --request GET \
  --url https://api.dojah.io/api/v1/general/bin \
  --header 'AppId: <appid>' \
  --header 'Authorization: <api-key>'
import requests

url = "https://api.dojah.io/api/v1/general/bin"

headers = {
    "AppId": "<appid>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {AppId: '<appid>', Authorization: '<api-key>'}};

fetch('https://api.dojah.io/api/v1/general/bin', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dojah.io/api/v1/general/bin",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "AppId: <appid>",
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

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

func main() {

	url := "https://api.dojah.io/api/v1/general/bin"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("AppId", "<appid>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.dojah.io/api/v1/general/bin")
  .header("AppId", "<appid>")
  .header("Authorization", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.dojah.io/api/v1/general/bin")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["AppId"] = '<appid>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "entity": [
    {
      "amount": 1000,
      "description": "9MOBILE 1.5GB data bundle",
      "plan": "9MOBILE_1.5GB"
    },
    {
      "amount": 2000,
      "description": "9MOBILE 4.5GB data bundle",
      "plan": "9MOBILE_4.5GB"
    },
    {
      "amount": 3000,
      "description": "9MOBILE 4GB data bundle",
      "plan": "9MOBILE_4GB"
    },
    {
      "amount": 4000,
      "description": "9MOBILE 11.5GB data bundle ",
      "plan": "9MOBILE_11.5GB"
    },
    {
      "amount": 5000,
      "description": "9MOBILE 15GB data bundle ",
      "plan": "9MOBILE_15GB"
    },
    {
      "amount": 18000,
      "description": "9MOBILE 27.5GB data bundle ",
      "plan": "9MOBILE_27.5GB"
    },
    {
      "amount": 27500,
      "description": "9MOBILE 30GB data bundle ",
      "plan": "9MOBILE_30GB"
    },
    {
      "amount": 55000,
      "description": "9MOBILE 60GB data bundle ",
      "plan": "9MOBILE_60GB"
    },
    {
      "amount": 50,
      "description": "AIRTEL 40 MB data bundle",
      "plan": "AIRTEL_40MB"
    },
    {
      "amount": 100,
      "description": "AIRTEL 100 MB data bundle",
      "plan": "AIRTEL_100MB"
    },
    {
      "amount": 200,
      "description": "AIRTEL 200 MB data bundle",
      "plan": "AIRTEL_200MB"
    },
    {
      "amount": 300,
      "description": "AIRTEL 350 MB data bundle",
      "plan": "AIRTEL_350MB"
    },
    {
      "amount": 500,
      "description": "AIRTEL 750 MB data bundle",
      "plan": "AIRTEL_750MB"
    },
    {
      "amount": 1000,
      "description": "AIRTEL 1.5GB data bundle",
      "plan": "AIRTEL_1.5GB"
    },
    {
      "amount": 1500,
      "description": "AIRTEL 3GB Data Bundle",
      "plan": "AIRTEL_3GB"
    },
    {
      "amount": 2500,
      "description": "AIRTEL 6GB Data Bundle",
      "plan": "AIRTEL_6GB"
    },
    {
      "amount": 3000,
      "description": "AIRTEL 8GB Data Bundle",
      "plan": "AIRTEL_8GB"
    },
    {
      "amount": 4000,
      "description": "AIRTEL 11GB Data Bundle",
      "plan": "AIRTEL_11GB"
    },
    {
      "amount": 5000,
      "description": "AIRTEL 15GB Data Bundle",
      "plan": "AIRTEL_15GB"
    },
    {
      "amount": 10000,
      "description": "AIRTEL 40GB Data Bundle",
      "plan": "AIRTEL_40GB"
    },
    {
      "amount": 15000,
      "description": "AIRTEL 75GB Data Bundle",
      "plan": "AIRTEL_75GB"
    },
    {
      "amount": 100,
      "description": "GLO 35 MB data bundle",
      "plan": "GLO_35MB"
    },
    {
      "amount": 200,
      "description": "GLO 100 MB DATA BUNDLE",
      "plan": "GLO_100MB"
    },
    {
      "amount": 500,
      "description": "GLO 920 MB DATA BUNDLE",
      "plan": "GLO_920MB"
    },
    {
      "amount": 1000,
      "description": "GLO 1.8GB data purchase",
      "plan": "GLO_1.8GB"
    },
    {
      "amount": 2000,
      "description": "GLO 4.5GB data bundle",
      "plan": "GLO_4.5GB"
    },
    {
      "amount": 2500,
      "description": "GLO 7.2GB data bundle",
      "plan": "GLO_7.2GB"
    },
    {
      "amount": 3000,
      "description": "GLO 8.75GB DATA BUNDLE",
      "plan": "GLO_8.75GB"
    },
    {
      "amount": 4000,
      "description": "GLO 12.5GB DATA BUNDLE",
      "plan": "GLO_12.5GB"
    },
    {
      "amount": 5000,
      "description": "GLO 15.6GB DATA BUNDLE",
      "plan": "GLO_15.6GB"
    },
    {
      "amount": 8000,
      "description": "GLO 25GB DATA BUNDLE",
      "plan": "GLO_25GB"
    },
    {
      "amount": 10000,
      "description": "GLO 32.5GB DATA BUNDLE",
      "plan": "GLO_32.5GB"
    },
    {
      "amount": 15000,
      "description": "GLO 52.5GB DATA BUNDLE",
      "plan": "GLO_52.5GB"
    },
    {
      "amount": 18000,
      "description": "GLO 62.5GB DATA BUNDLE",
      "plan": "GLO_62.5GB"
    },
    {
      "amount": 200,
      "description": "MTN 200 MB DATA BUNDLE",
      "plan": "MTN_200MB"
    },
    {
      "amount": 500,
      "description": "MTN 750MB data top-up service",
      "plan": "MTN_750MB"
    },
    {
      "amount": 1000,
      "description": "MTN 1.5 GB DATA BUNDLE",
      "plan": "MTN_1.5GB"
    },
    {
      "amount": 2000,
      "description": "MTN 4.5 GB DATA BUNDLE",
      "plan": "MTN_4.5GB"
    },
    {
      "amount": 3500,
      "description": "MTN 10 GB DATA BUNDLE",
      "plan": "MTN_10GB"
    },
    {
      "amount": 5000,
      "description": "MTN 15 GB DATA BUNDLE",
      "plan": "MTN_15GB"
    },
    {
      "amount": 10000,
      "description": "MTN 40 GB DATA BUNDLE",
      "plan": "MTN_40GB"
    },
    {
      "amount": 20000,
      "description": "MTN 75 GB DATA BUNDLE",
      "plan": "MTN_75GB"
    },
    {
      "amount": 50000,
      "description": "MTN 120 GB DATA BUNDLE",
      "plan": "MTN_120GB"
    }
  ]
}

{
  "error": "Invalid request parameters"
}

{
  "error": "App Couldn't be Validated"
}
​
AppId
string
required
Application ID from dashboard

​
RESPONSES

​
200
json
json
​
400
Object
​
401
Object

{
  "entity": [
    {
      "amount": 1000,
      "description": "9MOBILE 1.5GB data bundle",
      "plan": "9MOBILE_1.5GB"
    },
    {
      "amount": 2000,
      "description": "9MOBILE 4.5GB data bundle",
      "plan": "9MOBILE_4.5GB"
    },
    {
      "amount": 3000,
      "description": "9MOBILE 4GB data bundle",
      "plan": "9MOBILE_4GB"
    },
    {
      "amount": 4000,
      "description": "9MOBILE 11.5GB data bundle ",
      "plan": "9MOBILE_11.5GB"
    },
    {
      "amount": 5000,
      "description": "9MOBILE 15GB data bundle ",
      "plan": "9MOBILE_15GB"
    },
    {
      "amount": 18000,
      "description": "9MOBILE 27.5GB data bundle ",
      "plan": "9MOBILE_27.5GB"
    },
    {
      "amount": 27500,
      "description": "9MOBILE 30GB data bundle ",
      "plan": "9MOBILE_30GB"
    },
    {
      "amount": 55000,
      "description": "9MOBILE 60GB data bundle ",
      "plan": "9MOBILE_60GB"
    },
    {
      "amount": 50,
      "description": "AIRTEL 40 MB data bundle",
      "plan": "AIRTEL_40MB"
    },
    {
      "amount": 100,
      "description": "AIRTEL 100 MB data bundle",
      "plan": "AIRTEL_100MB"
    },
    {
      "amount": 200,
      "description": "AIRTEL 200 MB data bundle",
      "plan": "AIRTEL_200MB"
    },
    {
      "amount": 300,
      "description": "AIRTEL 350 MB data bundle",
      "plan": "AIRTEL_350MB"
    },
    {
      "amount": 500,
      "description": "AIRTEL 750 MB data bundle",
      "plan": "AIRTEL_750MB"
    },
    {
      "amount": 1000,
      "description": "AIRTEL 1.5GB data bundle",
      "plan": "AIRTEL_1.5GB"
    },
    {
      "amount": 1500,
      "description": "AIRTEL 3GB Data Bundle",
      "plan": "AIRTEL_3GB"
    },
    {
      "amount": 2500,
      "description": "AIRTEL 6GB Data Bundle",
      "plan": "AIRTEL_6GB"
    },
    {
      "amount": 3000,
      "description": "AIRTEL 8GB Data Bundle",
      "plan": "AIRTEL_8GB"
    },
    {
      "amount": 4000,
      "description": "AIRTEL 11GB Data Bundle",
      "plan": "AIRTEL_11GB"
    },
    {
      "amount": 5000,
      "description": "AIRTEL 15GB Data Bundle",
      "plan": "AIRTEL_15GB"
    },
    {
      "amount": 10000,
      "description": "AIRTEL 40GB Data Bundle",
      "plan": "AIRTEL_40GB"
    },
    {
      "amount": 15000,
      "description": "AIRTEL 75GB Data Bundle",
      "plan": "AIRTEL_75GB"
    },
    {
      "amount": 100,
      "description": "GLO 35 MB data bundle",
      "plan": "GLO_35MB"
    },
    {
      "amount": 200,
      "description": "GLO 100 MB DATA BUNDLE",
      "plan": "GLO_100MB"
    },
    {
      "amount": 500,
      "description": "GLO 920 MB DATA BUNDLE",
      "plan": "GLO_920MB"
    },
    {
      "amount": 1000,
      "description": "GLO 1.8GB data purchase",
      "plan": "GLO_1.8GB"
    },
    {
      "amount": 2000,
      "description": "GLO 4.5GB data bundle",
      "plan": "GLO_4.5GB"
    },
    {
      "amount": 2500,
      "description": "GLO 7.2GB data bundle",
      "plan": "GLO_7.2GB"
    },
    {
      "amount": 3000,
      "description": "GLO 8.75GB DATA BUNDLE",
      "plan": "GLO_8.75GB"
    },
    {
      "amount": 4000,
      "description": "GLO 12.5GB DATA BUNDLE",
      "plan": "GLO_12.5GB"
    },
    {
      "amount": 5000,
      "description": "GLO 15.6GB DATA BUNDLE",
      "plan": "GLO_15.6GB"
    },
    {
      "amount": 8000,
      "description": "GLO 25GB DATA BUNDLE",
      "plan": "GLO_25GB"
    },
    {
      "amount": 10000,
      "description": "GLO 32.5GB DATA BUNDLE",
      "plan": "GLO_32.5GB"
    },
    {
      "amount": 15000,
      "description": "GLO 52.5GB DATA BUNDLE",
      "plan": "GLO_52.5GB"
    },
    {
      "amount": 18000,
      "description": "GLO 62.5GB DATA BUNDLE",
      "plan": "GLO_62.5GB"
    },
    {
      "amount": 200,
      "description": "MTN 200 MB DATA BUNDLE",
      "plan": "MTN_200MB"
    },
    {
      "amount": 500,
      "description": "MTN 750MB data top-up service",
      "plan": "MTN_750MB"
    },
    {
      "amount": 1000,
      "description": "MTN 1.5 GB DATA BUNDLE",
      "plan": "MTN_1.5GB"
    },
    {
      "amount": 2000,
      "description": "MTN 4.5 GB DATA BUNDLE",
      "plan": "MTN_4.5GB"
    },
    {
      "amount": 3500,
      "description": "MTN 10 GB DATA BUNDLE",
      "plan": "MTN_10GB"
    },
    {
      "amount": 5000,
      "description": "MTN 15 GB DATA BUNDLE",
      "plan": "MTN_15GB"
    },
    {
      "amount": 10000,
      "description": "MTN 40 GB DATA BUNDLE",
      "plan": "MTN_40GB"
    },
    {
      "amount": 20000,
      "description": "MTN 75 GB DATA BUNDLE",
      "plan": "MTN_75GB"
    },
    {
      "amount": 50000,
      "description": "MTN 120 GB DATA BUNDLE",
      "plan": "MTN_120GB"
    }
  ]
}

{
  "error": "Invalid request parameters"
}

{
  "error": "App Couldn't be Validated"
}