Countries

Get all available countries for international top-up.

Endpoint: POST /international-bridge/countries

Request

cURL

curl -X POST https://API-ENDPOINT/international-bridge/countries \
  -H "Content-Type: application/json" \
  -d '{
    "auth": {
      "id": 123,
      "key": 1706360400000,
      "hash": "a1b2c3d4e5f6..."
    }
  }'

PHP

<?php
$url = 'https://API-ENDPOINT/international-bridge/countries';
$key = time() * 1000;

$data = [
    'auth' => [
        'id' => 123,
        'key' => $key,
        'hash' => md5(123 . $token . $key)
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Node.js

const key = Date.now();
const hash = md5(`123${token}${key}`);

const response = await fetch('https://API-ENDPOINT/international-bridge/countries', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    auth: { id: 123, key, hash }
  })
});

const data = await response.json();
console.log(data);

Python

import requests
import hashlib
import time

url = 'https://API-ENDPOINT/international-bridge/countries'
key = int(time.time() * 1000)
hash_value = hashlib.md5(f"123{token}{key}".encode()).hexdigest()

response = requests.post(url, json={
    'auth': {
        'id': 123,
        'key': key,
        'hash': hash_value
    }
})

print(response.json())

Response

{
  "countries": [
    {
      "id": "IND",
      "name": "India",
      "phone_code": "+91",
      "phone_mask": "+91 ($$$) $$$-$$-$$",
      "currency": "INR",
      "logo": "https://API-ENDPOINT/static-media/country-flags/IND.png",
      "logo_large": "https://API-ENDPOINT/static-media/country-flags-large/IND.png"
    },
    {
      "id": "IDN",
      "name": "Indonesia",
      "phone_code": "+62",
      "phone_mask": "+62 *",
      "currency": "IDR",
      "logo": "https://API-ENDPOINT/static-media/country-flags/IDN.png",
      "logo_large": "https://API-ENDPOINT/static-media/country-flags-large/IDN.png"
    },
    {
      "id": "PAK",
      "name": "Pakistan",
      "phone_code": "+92",
      "phone_mask": "+92 (3$$) $$$-$$$$",
      "currency": "PKR",
      "logo": "https://API-ENDPOINT/static-media/country-flags/PAK.png",
      "logo_large": "https://API-ENDPOINT/static-media/country-flags-large/PAK.png"
    }
  ]
}

Response Fields

Field	Type	Description
id	string	ISO 3-letter country code
name	string	Country name
phone_code	string	International dialing code
phone_mask	string	Phone number input mask ($ = digit, * = variable length)
currency	string	Local currency code
logo	string	Country flag URL (small)
logo_large	string	Country flag URL (large)

Next Step

Choose a country and fetch its operators via Providers.