GSUBZ API documentation

curl --location 'https://api.gsubz.com/api/balance/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'api="YOUR_API_KEY"'

<?php
$ch = curl_init('https://api.gsubz.com/api/balance/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'api' => 'YOUR_API_KEY',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("api", "YOUR_API_KEY");

const response = await fetch("https://api.gsubz.com/api/balance/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/balance/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "api": "YOUR_API_KEY",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "balance": "747.5"
}

curl --location 'https://api.gsubz.com/api/category/'

<?php
$ch = curl_init('https://api.gsubz.com/api/category/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/category/");
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/category/"
payload = {
}

response = requests.get(url, params=payload, timeout=60)
print(response.json())

[
  {
    "name": "electricity",
    "displayName": "Electricity",
    "image": "//gsubz.com/uploads/2021/9/1/electric-icon.png",
    "services": [
      {
        "serviceID": "eko-electric",
        "displayName": "Eko (EKEDC)"
      },
      {
        "serviceID": "kaduna-electric",
        "displayName": "Kaduna Electric"
      }
    ]
  },
  {
    "name": "cable",
    "displayName": "Cable TV",
    "image": "//gsubz.com/uploads/2021/9/1/cable-icon.png",
    "services": [
      {
        "serviceID": "gotv",
        "displayName": "GOtv"
      }
    ]
  }
]

curl --location 'https://api.gsubz.com/api/plans/?service=mtn_sme'

<?php
$ch = curl_init('https://api.gsubz.com/api/plans/?service=mtn_sme');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/plans/?service=mtn_sme");
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/plans/"
payload = {
    "service": "mtn_sme",
}

response = requests.get(url, params=payload, timeout=60)
print(response.json())

{
  "service": "MTN-SME-Data(*461*4#)",
  "PlanName": "plan",
  "fixedPrice": true,
  "discount": "4.81%",
  "plans": [
    {
      "displayName": "10GB - 30days",
      "value": "260",
      "price": "2400",
      "api_price": "2284.56"
    }
  ]
}

curl --location 'https://api.gsubz.com/api/verify-customer/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'api="YOUR_API_KEY"' \
--form 'serviceID="kaduna_electric"' \
--form 'billersCode="00000000000"' \
--form 'type="prepaid"'

<?php
$ch = curl_init('https://api.gsubz.com/api/verify-customer/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'api' => 'YOUR_API_KEY',
        'serviceID' => 'kaduna_electric',
        'billersCode' => '00000000000',
        'type' => 'prepaid',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("api", "YOUR_API_KEY");
form.append("serviceID", "kaduna_electric");
form.append("billersCode", "00000000000");
form.append("type", "prepaid");

const response = await fetch("https://api.gsubz.com/api/verify-customer/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/verify-customer/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "api": "YOUR_API_KEY",
    "serviceID": "kaduna_electric",
    "billersCode": "00000000000",
    "type": "prepaid",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "description": "CUSTOMER_FOUND",
  "content": {
    "customerName": "JOHN ADEBAYO",
    "address": "12 SAMPLE STREET, IKEJA",
    "meterNumber": "45000000000",
    "meterType": "PREPAID",
    "accountType": null,
    "canVend": "yes"
  }
}

{
  "code": 404,
  "status": "failed",
  "description": "CONTENT_NOT_FOUND",
  "api_response": "Could not verify this meter number"
}

curl --location 'https://api.gsubz.com/api/pay/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'serviceID="mtn_sme"' \
--form 'plan="260"' \
--form 'api="YOUR_API_KEY"' \
--form 'amount=""' \
--form 'phone="08031234567"' \
--form 'requestID="8dhbc8w7huwh8hw9hew9"'

<?php
$ch = curl_init('https://api.gsubz.com/api/pay/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'serviceID' => 'mtn_sme',
        'plan' => '260',
        'api' => 'YOUR_API_KEY',
        'amount' => '',
        'phone' => '08031234567',
        'requestID' => '8dhbc8w7huwh8hw9hew9',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("serviceID", "mtn_sme");
form.append("plan", "260");
form.append("api", "YOUR_API_KEY");
form.append("amount", "");
form.append("phone", "08031234567");
form.append("requestID", "8dhbc8w7huwh8hw9hew9");

const response = await fetch("https://api.gsubz.com/api/pay/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/pay/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "serviceID": "mtn_sme",
    "plan": "260",
    "api": "YOUR_API_KEY",
    "amount": "",
    "phone": "08031234567",
    "requestID": "8dhbc8w7huwh8hw9hew9",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": 3878886201,
  "amount": 2400,
  "phone": "08031234567",
  "serviceID": "mtn_sme",
  "amountPaid": 2284.56,
  "initialBalance": 5000,
  "finalBalance": 2715.44,
  "date": "2026-09-28T09:47:15+01:00",
  "api_response": "Dear Customer, You have successfully shared 10GB Data to 2348031234567. Thankyou"
}

curl --location 'https://api.gsubz.com/api/pay/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'serviceID="mtn"' \
--form 'api="YOUR_API_KEY"' \
--form 'amount="100"' \
--form 'phone="08031234567"' \
--form 'requestID="8dhbc8w7huwh8hw9hew9"'

<?php
$ch = curl_init('https://api.gsubz.com/api/pay/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'serviceID' => 'mtn',
        'api' => 'YOUR_API_KEY',
        'amount' => '100',
        'phone' => '08031234567',
        'requestID' => '8dhbc8w7huwh8hw9hew9',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("serviceID", "mtn");
form.append("api", "YOUR_API_KEY");
form.append("amount", "100");
form.append("phone", "08031234567");
form.append("requestID", "8dhbc8w7huwh8hw9hew9");

const response = await fetch("https://api.gsubz.com/api/pay/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/pay/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "serviceID": "mtn",
    "api": "YOUR_API_KEY",
    "amount": "100",
    "phone": "08031234567",
    "requestID": "8dhbc8w7huwh8hw9hew9",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": 3768661863,
  "amount": 800,
  "phone": "08031234567",
  "serviceID": "mtn",
  "amountPaid": 768,
  "initialBalance": 5000,
  "finalBalance": 4232,
  "date": "2026-09-28T09:47:15+01:00",
  "api_response": "You have topped up N800.00 to 2348031234567. ref: 2026092809402519057879292"
}

curl --location 'https://api.gsubz.com/api/pay/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'serviceID="gotv"' \
--form 'api="YOUR_API_KEY"' \
--form 'variation_code="gotv-smallie"' \
--form 'phone="08031234567"' \
--form 'amount=""' \
--form 'customerID="0000000000"' \
--form 'requestID="8dhbc8w7huwh8hw9hew9"'

<?php
$ch = curl_init('https://api.gsubz.com/api/pay/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'serviceID' => 'gotv',
        'api' => 'YOUR_API_KEY',
        'variation_code' => 'gotv-smallie',
        'phone' => '08031234567',
        'amount' => '',
        'customerID' => '0000000000',
        'requestID' => '8dhbc8w7huwh8hw9hew9',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("serviceID", "gotv");
form.append("api", "YOUR_API_KEY");
form.append("variation_code", "gotv-smallie");
form.append("phone", "08031234567");
form.append("amount", "");
form.append("customerID", "0000000000");
form.append("requestID", "8dhbc8w7huwh8hw9hew9");

const response = await fetch("https://api.gsubz.com/api/pay/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/pay/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "serviceID": "gotv",
    "api": "YOUR_API_KEY",
    "variation_code": "gotv-smallie",
    "phone": "08031234567",
    "amount": "",
    "customerID": "0000000000",
    "requestID": "8dhbc8w7huwh8hw9hew9",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": 3685573902,
  "amount": 900,
  "phone": "08031234567",
  "serviceID": "gotv",
  "amountPaid": 882,
  "initialBalance": 5000,
  "finalBalance": 4118,
  "date": "2026-09-28T09:47:15+01:00",
  "api_response": "Your GOtv subscription was successful."
}

curl --location 'https://api.gsubz.com/api/pay/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'serviceID="kaduna_electric"' \
--form 'api="YOUR_API_KEY"' \
--form 'phone="08031234567"' \
--form 'customerID="00000000000"' \
--form 'amount="1100"' \
--form 'variation_code="prepaid"' \
--form 'requestID="8dhbc8w7huwh8hw9hew9"'

<?php
$ch = curl_init('https://api.gsubz.com/api/pay/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'serviceID' => 'kaduna_electric',
        'api' => 'YOUR_API_KEY',
        'phone' => '08031234567',
        'customerID' => '00000000000',
        'amount' => '1100',
        'variation_code' => 'prepaid',
        'requestID' => '8dhbc8w7huwh8hw9hew9',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("serviceID", "kaduna_electric");
form.append("api", "YOUR_API_KEY");
form.append("phone", "08031234567");
form.append("customerID", "00000000000");
form.append("amount", "1100");
form.append("variation_code", "prepaid");
form.append("requestID", "8dhbc8w7huwh8hw9hew9");

const response = await fetch("https://api.gsubz.com/api/pay/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/pay/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "serviceID": "kaduna_electric",
    "api": "YOUR_API_KEY",
    "phone": "08031234567",
    "customerID": "00000000000",
    "amount": "1100",
    "variation_code": "prepaid",
    "requestID": "8dhbc8w7huwh8hw9hew9",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": 3574357094,
  "amount": 1100,
  "phone": "08031234567",
  "serviceID": "kaduna_electric",
  "amountPaid": 1100,
  "initialBalance": 5000,
  "finalBalance": 3900,
  "date": "2026-09-28T09:47:15+01:00",
  "api_response": "Token: 47488383838383838383833"
}

curl --location 'https://api.gsubz.com/api/pay/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'serviceID="waec"' \
--form 'plan="waecdirect"' \
--form 'api="YOUR_API_KEY"' \
--form 'amount=""' \
--form 'phone="08031234567"' \
--form 'requestID="87dfhw8dbw8e7hw9d9dh"'

<?php
$ch = curl_init('https://api.gsubz.com/api/pay/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'serviceID' => 'waec',
        'plan' => 'waecdirect',
        'api' => 'YOUR_API_KEY',
        'amount' => '',
        'phone' => '08031234567',
        'requestID' => '87dfhw8dbw8e7hw9d9dh',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("serviceID", "waec");
form.append("plan", "waecdirect");
form.append("api", "YOUR_API_KEY");
form.append("amount", "");
form.append("phone", "08031234567");
form.append("requestID", "87dfhw8dbw8e7hw9d9dh");

const response = await fetch("https://api.gsubz.com/api/pay/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/pay/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "serviceID": "waec",
    "plan": "waecdirect",
    "api": "YOUR_API_KEY",
    "amount": "",
    "phone": "08031234567",
    "requestID": "87dfhw8dbw8e7hw9d9dh",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": 3075647209,
  "amount": 3500,
  "phone": "08031234567",
  "serviceID": "waec",
  "amountPaid": 3500,
  "initialBalance": 5000,
  "finalBalance": 1500,
  "date": "2026-09-28T09:47:15+01:00",
  "api_response": "968686868685<=>WRN2056666666"
}

curl --location 'https://api.gsubz.com/api/pay/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'serviceID="socials"' \
--form 'plan="179"' \
--form 'api="YOUR_API_KEY"' \
--form 'amount=""' \
--form 'link="https://instagram.com/gsubzonline"' \
--form 'quantity="1000"' \
--form 'requestID="8dhbc8w7huwh8hw9hew9"'

<?php
$ch = curl_init('https://api.gsubz.com/api/pay/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'serviceID' => 'socials',
        'plan' => '179',
        'api' => 'YOUR_API_KEY',
        'amount' => '',
        'link' => 'https://instagram.com/gsubzonline',
        'quantity' => '1000',
        'requestID' => '8dhbc8w7huwh8hw9hew9',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("serviceID", "socials");
form.append("plan", "179");
form.append("api", "YOUR_API_KEY");
form.append("amount", "");
form.append("link", "https://instagram.com/gsubzonline");
form.append("quantity", "1000");
form.append("requestID", "8dhbc8w7huwh8hw9hew9");

const response = await fetch("https://api.gsubz.com/api/pay/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/pay/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "serviceID": "socials",
    "plan": "179",
    "api": "YOUR_API_KEY",
    "amount": "",
    "link": "https://instagram.com/gsubzonline",
    "quantity": "1000",
    "requestID": "8dhbc8w7huwh8hw9hew9",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": 3075647200,
  "amount": 179,
  "serviceID": "socials",
  "amountPaid": 179,
  "initialBalance": 5000,
  "finalBalance": 4821,
  "date": "2026-09-28T09:47:15+01:00",
  "api_response": "Order received. Order ID: 39554883"
}

curl --location 'https://api.gsubz.com/api/generate/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'network="airtel"' \
--form 'value="500"' \
--form 'number="1"'

<?php
$ch = curl_init('https://api.gsubz.com/api/generate/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'network' => 'airtel',
        'value' => '500',
        'number' => '1',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("network", "airtel");
form.append("value", "500");
form.append("number", "1");

const response = await fetch("https://api.gsubz.com/api/generate/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/generate/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "network": "airtel",
    "value": "500",
    "number": "1",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "message": "We Received your order, 1 of 1 delivered\n Thank you for your patronage",
  "status": "success",
  "id": "c143e774874a59623aa928292d128f97",
  "network": "Airtel",
  "value": "500",
  "number": "1",
  "delivered": "1",
  "pending": 0,
  "pins": [
    {
      "pin": "5794977707301520",
      "sn": "26026825914918714922"
    }
  ]
}

curl --location 'https://api.gsubz.com/api/generate/history/' \
--header 'Authorization: Bearer YOUR_API_KEY'

<?php
$ch = curl_init('https://api.gsubz.com/api/generate/history/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/generate/history/", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/generate/history/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
}

response = requests.get(url, headers=headers, params=payload, timeout=60)
print(response.json())

{
  "code": "200",
  "status": "TRANSACTION_SUCCESSFUL",
  "count": 1,
  "orders": [
    {
      "order_id": "c143e774874a59623aa928292d128f97",
      "description": "Airtel-500-1 28/09/2026",
      "network": "airtel",
      "value": "500",
      "requested": 1,
      "delivered": 1,
      "amount_paid": "485",
      "status": "success",
      "timestamp": 1790585235,
      "date": "2026-09-28 09:47:15",
      "pins": [
        {
          "pin": "5794977707301520",
          "sn": "26026825914918714922"
        }
      ]
    }
  ]
}

{
  "code": "404",
  "description": "ORDER_NOT_FOUND",
  "status": "TRANSACTION_FAILED"
}

curl --location 'https://api.gsubz.com/api/esim/countries/?q=fra'

<?php
$ch = curl_init('https://api.gsubz.com/api/esim/countries/?q=fra');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/esim/countries/?q=fra");
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/esim/countries/"
payload = {
    "q": "fra",
}

response = requests.get(url, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "countries": [
    {
      "country": "France",
      "locationCodes": "FR",
      "plans": 12
    },
    {
      "country": "Spain",
      "locationCodes": "ES",
      "plans": 9
    }
  ]
}

curl --location 'https://api.gsubz.com/api/esim/packages/?locationCode=FR'

<?php
$ch = curl_init('https://api.gsubz.com/api/esim/packages/?locationCode=FR');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/esim/packages/?locationCode=FR");
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/esim/packages/"
payload = {
    "locationCode": "FR",
}

response = requests.get(url, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "packages": [
    {
      "packageCode": "FR_1_7",
      "name": "France 1GB 7Days",
      "country": "France",
      "dataGB": 1,
      "duration": 7,
      "durationUnit": "DAY",
      "price": 2607,
      "refundable": true,
      "topUp": true
    }
  ]
}

curl --location 'https://api.gsubz.com/api/esim/buy/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'api="YOUR_API_KEY"' \
--form 'packageCode="FR_1_7"' \
--form 'requestID="esim-1001"'

<?php
$ch = curl_init('https://api.gsubz.com/api/esim/buy/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'api' => 'YOUR_API_KEY',
        'packageCode' => 'FR_1_7',
        'requestID' => 'esim-1001',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("api", "YOUR_API_KEY");
form.append("packageCode", "FR_1_7");
form.append("requestID", "esim-1001");

const response = await fetch("https://api.gsubz.com/api/esim/buy/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/esim/buy/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "api": "YOUR_API_KEY",
    "packageCode": "FR_1_7",
    "requestID": "esim-1001",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": "ESIMA0BA0EC673A45212",
  "orderID": 1,
  "amount": 3476,
  "serviceID": "esim",
  "amountPaid": 3476,
  "initialBalance": 100000,
  "finalBalance": 96524,
  "date": "2026-09-28T12:36:59+01:00",
  "api_response": "Your eSIM is ready. Scan the QR code or enter the activation code to install it.",
  "requestID": "esim-1001",
  "packageCode": "FR_1_7",
  "packageName": "France 1GB 7Days",
  "country": "France",
  "esimStatus": "active",
  "iccid": "8944500102030405060",
  "activationCode": "LPA:1$rsp.example.com$ABCD-1234-EFGH",
  "qrCodeUrl": "https://example.com/qr/ORD-123"
}

{
  "code": 402,
  "status": "failed",
  "description": "INSUFFICIENT_BALANCE",
  "api_response": "Insufficient balance. This eSIM costs ₦3,476.00 but your wallet has ₦100.00."
}

curl --location 'https://api.gsubz.com/api/esim/orders/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'api="YOUR_API_KEY"' \
--form 'requestID="esim-1001"' \
--form 'orderID="1"'

<?php
$ch = curl_init('https://api.gsubz.com/api/esim/orders/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'api' => 'YOUR_API_KEY',
        'requestID' => 'esim-1001',
        'orderID' => '1',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("api", "YOUR_API_KEY");
form.append("requestID", "esim-1001");
form.append("orderID", "1");

const response = await fetch("https://api.gsubz.com/api/esim/orders/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/esim/orders/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "api": "YOUR_API_KEY",
    "requestID": "esim-1001",
    "orderID": "1",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "orders": [
    {
      "orderID": 1,
      "transactionID": "ESIMA0BA0EC673A45212",
      "packageCode": "FR_1_7",
      "packageName": "France 1GB 7Days",
      "country": "France",
      "amountPaid": 3476,
      "amountRefunded": 0,
      "esimStatus": "active",
      "iccid": "8944500102030405060",
      "activationCode": "LPA:1$rsp.example.com$ABCD-1234-EFGH",
      "qrCodeUrl": "https://example.com/qr/ORD-123",
      "date": "2026-09-28T12:36:59+01:00"
    }
  ]
}

{
  "code": 404,
  "status": "failed",
  "description": "CONTENT_NOT_FOUND",
  "api_response": "No eSIM order found for that reference."
}

curl --location 'https://api.gsubz.com/api/esim/cancel/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'api="YOUR_API_KEY"' \
--form 'orderID="1"'

<?php
$ch = curl_init('https://api.gsubz.com/api/esim/cancel/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'api' => 'YOUR_API_KEY',
        'orderID' => '1',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("api", "YOUR_API_KEY");
form.append("orderID", "1");

const response = await fetch("https://api.gsubz.com/api/esim/cancel/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/esim/cancel/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "api": "YOUR_API_KEY",
    "orderID": "1",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "orderID": 1,
  "amountRefunded": 3476,
  "initialBalance": 96524,
  "finalBalance": 100000,
  "date": "2026-09-28T12:37:22+01:00",
  "api_response": "Refunded ₦3,476.00."
}

{
  "code": 406,
  "status": "failed",
  "description": "NOT_CANCELLABLE",
  "api_response": "This eSIM cannot be cancelled. It may already be in use."
}

curl --location 'https://api.gsubz.com/api/games/list/?q=free'

<?php
$ch = curl_init('https://api.gsubz.com/api/games/list/?q=free');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/games/list/?q=free");
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/games/list/"
payload = {
    "q": "free",
}

response = requests.get(url, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "games": [
    {
      "gameID": 12,
      "name": "Free Fire",
      "image": "https://gsubz.com/uploads/gaming/free-fire.png",
      "note": null,
      "lines": 2,
      "products": 24,
      "fromPrice": 1440
    },
    {
      "gameID": 20,
      "name": "Roblox",
      "image": "https://gsubz.com/uploads/gaming/roblox.png",
      "note": "Codes arrive within seconds.",
      "lines": 1,
      "products": 8,
      "fromPrice": 8000
    }
  ]
}

curl --location 'https://api.gsubz.com/api/games/products/?gameID=12'

<?php
$ch = curl_init('https://api.gsubz.com/api/games/products/?gameID=12');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/games/products/?gameID=12");
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/games/products/"
payload = {
    "gameID": "12",
}

response = requests.get(url, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "game": {
    "gameID": 12,
    "name": "Free Fire",
    "image": "https://gsubz.com/uploads/gaming/free-fire.png",
    "note": null
  },
  "lines": [
    {
      "lineID": 467,
      "name": "Direct Topup Mena",
      "region": "Mena",
      "requirements": [
        {
          "field": "player_id",
          "label": "Player ID",
          "type": "text",
          "required": true,
          "options": null
        }
      ],
      "products": [
        {
          "productID": "101",
          "name": "100 Diamonds",
          "price": 1520,
          "kind": "amount",
          "inStock": true
        },
        {
          "productID": "102",
          "name": "Weekly Membership",
          "price": 5200,
          "kind": "pack",
          "inStock": null
        }
      ]
    }
  ]
}

{
  "code": 404,
  "status": "failed",
  "description": "CONTENT_NOT_FOUND",
  "api_response": "That game is not available."
}

curl --location 'https://api.gsubz.com/api/games/validate/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'productID="101"' \
--form 'player_id="12345678"'

<?php
$ch = curl_init('https://api.gsubz.com/api/games/validate/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'productID' => '101',
        'player_id' => '12345678',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("productID", "101");
form.append("player_id", "12345678");

const response = await fetch("https://api.gsubz.com/api/games/validate/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/games/validate/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "productID": "101",
    "player_id": "12345678",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "description": "PLAYER_FOUND",
  "playerName": "ProGamer99",
  "region": "AF",
  "api_response": "Player found."
}

{
  "code": 404,
  "status": "failed",
  "description": "PLAYER_NOT_FOUND",
  "api_response": "We could not find that player ID. Please check it and try again."
}

curl --location 'https://api.gsubz.com/api/games/buy/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'productID="101"' \
--form 'player_id="12345678"' \
--form 'requestID="game-1001"'

<?php
$ch = curl_init('https://api.gsubz.com/api/games/buy/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'productID' => '101',
        'player_id' => '12345678',
        'requestID' => 'game-1001',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("productID", "101");
form.append("player_id", "12345678");
form.append("requestID", "game-1001");

const response = await fetch("https://api.gsubz.com/api/games/buy/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/games/buy/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "productID": "101",
    "player_id": "12345678",
    "requestID": "game-1001",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": "GM261007113015A1B2C3D4",
  "orderID": 15,
  "amount": 1520,
  "serviceID": "games",
  "amountPaid": 1520,
  "initialBalance": 100000,
  "finalBalance": 98480,
  "date": "2026-10-07T11:30:15+01:00",
  "api_response": "Your order is complete.",
  "requestID": "game-1001",
  "game": "Free Fire · Direct Topup Mena",
  "product": "100 Diamonds",
  "orderStatus": "completed",
  "playerName": "ProGamer99",
  "codes": []
}

{
  "code": 404,
  "status": "failed",
  "description": "PLAYER_NOT_FOUND",
  "api_response": "We could not find that player ID. Please check it and try again. You have not been charged."
}

curl --location 'https://api.gsubz.com/api/games/orders/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'requestID="game-1001"' \
--form 'orderID="15"' \
--form 'transactionID="GM261007113015A1B2C3D4"'

<?php
$ch = curl_init('https://api.gsubz.com/api/games/orders/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'requestID' => 'game-1001',
        'orderID' => '15',
        'transactionID' => 'GM261007113015A1B2C3D4',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("requestID", "game-1001");
form.append("orderID", "15");
form.append("transactionID", "GM261007113015A1B2C3D4");

const response = await fetch("https://api.gsubz.com/api/games/orders/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/games/orders/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "requestID": "game-1001",
    "orderID": "15",
    "transactionID": "GM261007113015A1B2C3D4",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "orders": [
    {
      "orderID": 15,
      "transactionID": "GM261007113015A1B2C3D4",
      "requestID": "game-1001",
      "game": "Free Fire · Direct Topup Mena",
      "product": "100 Diamonds",
      "amount": 1520,
      "amountPaid": 1520,
      "amountRefunded": 0,
      "orderStatus": "completed",
      "playerName": "ProGamer99",
      "codes": [],
      "date": "2026-10-07T11:30:15+01:00"
    }
  ]
}

{
  "code": 404,
  "status": "failed",
  "description": "CONTENT_NOT_FOUND",
  "api_response": "No game order found for that reference."
}

curl --location 'https://api.gsubz.com/api/sms/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'api="YOUR_API_KEY"' \
--form 'from="MyShop"' \
--form 'to="08031234567,08021234568"' \
--form 'msg="Hello, your order is ready for pickup."' \
--form 'requestID="sms-1001"'

<?php
$ch = curl_init('https://api.gsubz.com/api/sms/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'api' => 'YOUR_API_KEY',
        'from' => 'MyShop',
        'to' => '08031234567,08021234568',
        'msg' => 'Hello, your order is ready for pickup.',
        'requestID' => 'sms-1001',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("api", "YOUR_API_KEY");
form.append("from", "MyShop");
form.append("to", "08031234567,08021234568");
form.append("msg", "Hello, your order is ready for pickup.");
form.append("requestID", "sms-1001");

const response = await fetch("https://api.gsubz.com/api/sms/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/sms/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "api": "YOUR_API_KEY",
    "from": "MyShop",
    "to": "08031234567,08021234568",
    "msg": "Hello, your order is ready for pickup.",
    "requestID": "sms-1001",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": 3530235131,
  "amount": 10,
  "serviceID": "bulk_sms",
  "amountPaid": 10,
  "initialBalance": 1000,
  "finalBalance": 990,
  "date": "2026-09-28T12:30:52+01:00",
  "api_response": "Your message was sent to 2 numbers.",
  "reference": "BSMSA260928123052FC8106",
  "requestID": "sms-1001",
  "sender": "MyShop",
  "recipients": 2,
  "sent": 2,
  "failed": 0,
  "skipped": 0,
  "pages": 1
}

{
  "code": 206,
  "status": "failed",
  "description": "MESSAGE_CONTENT_BLOCKED",
  "api_response": "This message would be blocked by the networks, so it was not sent. The networks block messages that mention international brands such as WhatsApp or Facebook.",
  "issues": [
    "The networks block messages that mention international brands such as WhatsApp or Facebook."
  ]
}

curl --location 'https://api.gsubz.com/api/flight/search/?q=lagos' \
--header 'Authorization: Bearer YOUR_API_KEY'

<?php
$ch = curl_init('https://api.gsubz.com/api/flight/search/?q=lagos');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/flight/search/?q=lagos", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/flight/search/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "q": "lagos",
}

response = requests.get(url, headers=headers, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "count": 1,
  "airports": [
    { "code": "LOS", "name": "Murtala Muhammed International Airport", "city": "Lagos", "country": "Nigeria" }
  ]
}

{
  "code": 401,
  "status": "failed",
  "description": "INVALID_API_OR_NOT_FOUND",
  "api_response": "This API key is not valid."
}

curl --location 'https://api.gsubz.com/api/flight/search/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'api="YOUR_API_KEY"' \
--form 'origin="LOS"' \
--form 'destination="ABV"' \
--form 'departure_date="2026-12-01"' \
--form 'adults="1"'

<?php
$ch = curl_init('https://api.gsubz.com/api/flight/search/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'api' => 'YOUR_API_KEY',
        'origin' => 'LOS',
        'destination' => 'ABV',
        'departure_date' => '2026-12-01',
        'adults' => '1',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("api", "YOUR_API_KEY");
form.append("origin", "LOS");
form.append("destination", "ABV");
form.append("departure_date", "2026-12-01");
form.append("adults", "1");

const response = await fetch("https://api.gsubz.com/api/flight/search/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/flight/search/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "api": "YOUR_API_KEY",
    "origin": "LOS",
    "destination": "ABV",
    "departure_date": "2026-12-01",
    "adults": "1",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "searchID": "FS3A9C41D07B22E8F5A61",
  "expiresAt": "2026-10-17T11:59:51+01:00",
  "currency": "NGN",
  "count": 1,
  "api_response": "Found 1 flight option.",
  "offers": [
    {
      "token": "eyJhbGciOi…",
      "airline": "Ibom Air",
      "airlineCode": "QI",
      "logo": "https://…/QI.png",
      "amount": 95000,
      "refundable": false,
      "journeys": [
        {
          "from": "LOS",
          "to": "ABV",
          "departsAt": "2026-12-01T08:00:00",
          "arrivesAt": "2026-12-01T09:10:00",
          "duration": "1h10",
          "stops": 0,
          "flightNumber": "QI 301",
          "baggage": "23KG baggage"
        }
      ]
    }
  ]
}

{
  "code": 206,
  "status": "failed",
  "description": "INVALID_CONTENT",
  "api_response": "origin and destination must be different."
}

curl --location 'https://api.gsubz.com/api/flight/book/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "searchID": "FS3A9C41D07B22E8F5A61",
    "token": "eyJhbGciOi…",
    "passengers": [
        {
            "type": "adult",
            "title": "Mr",
            "first_name": "Ada",
            "last_name": "Obi",
            "gender": "male"
        }
    ],
    "contact": {
        "email": "[email protected]",
        "phone": "08031234567"
    },
    "requestID": "flight-1001",
    "preview": true
}'

<?php
$payload = [
    'searchID' => 'FS3A9C41D07B22E8F5A61',
    'token' => 'eyJhbGciOi…',
    'passengers' => [
        [
            'type' => 'adult',
            'title' => 'Mr',
            'first_name' => 'Ada',
            'last_name' => 'Obi',
            'gender' => 'male',
        ],
    ],
    'contact' => [
        'email' => '[email protected]',
        'phone' => '08031234567',
    ],
    'requestID' => 'flight-1001',
    'preview' => true,
];

$ch = curl_init('https://api.gsubz.com/api/flight/book/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);
$response = curl_exec($ch);
curl_close($ch);

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

const payload = {
    "searchID": "FS3A9C41D07B22E8F5A61",
    "token": "eyJhbGciOi…",
    "passengers": [
        {
            "type": "adult",
            "title": "Mr",
            "first_name": "Ada",
            "last_name": "Obi",
            "gender": "male"
        }
    ],
    "contact": {
        "email": "[email protected]",
        "phone": "08031234567"
    },
    "requestID": "flight-1001",
    "preview": true
};

const response = await fetch("https://api.gsubz.com/api/flight/book/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/flight/book/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "searchID": "FS3A9C41D07B22E8F5A61",
    "token": "eyJhbGciOi…",
    "passengers": [
        {
            "type": "adult",
            "title": "Mr",
            "first_name": "Ada",
            "last_name": "Obi",
            "gender": "male",
        },
    ],
    "contact": {
        "email": "[email protected]",
        "phone": "08031234567",
    },
    "requestID": "flight-1001",
    "preview": True,
}

response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "transactionID": "TRV261017110002AB12CD34",
  "amount": 95000,
  "serviceID": "flight",
  "amountPaid": 95000,
  "initialBalance": 500000,
  "finalBalance": 405000,
  "date": "2026-10-17T11:00:02+01:00",
  "api_response": "Your booking is being processed and you have been charged. The result is sent to your webhook as flight.order.updated, or check it with Fetch Flight Orders.",
  "requestID": "flight-1001",
  "orderStatus": "processing",
  "tripType": "oneway",
  "origin": "LOS",
  "destination": "ABV",
  "departureDate": "2026-12-01",
  "returnDate": null,
  "airline": "Ibom Air",
  "journeys": [
    { "from": "LOS", "to": "ABV", "departsAt": "2026-12-01T08:00:00", "arrivesAt": "2026-12-01T09:10:00", "duration": "1h10", "stops": 0, "flightNumber": "QI 301", "baggage": "23KG baggage" }
  ],
  "passengers": [
    { "type": "Adult", "title": "Mr", "firstName": "Ada", "middleName": null, "lastName": "Obi", "gender": "Male", "countryCode": "NG" }
  ],
  "contact": { "email": "[email protected]", "phone": "+2348031234567" },
  "amountRefunded": 0,
  "pnr": null,
  "tickets": []
}

{
  "code": 406,
  "status": "failed",
  "description": "PRICE_CHANGED",
  "api_response": "The price is now ₦98,500.00, above your maxAmount. Nothing was charged. Send the same request with the quoteID in this response to book at the new price.",
  "quoteID": "Q1b2c3d4",
  "currentAmount": 98500,
  "expiresIn": 1700
}

curl --location 'https://api.gsubz.com/api/flight/orders/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'api="YOUR_API_KEY"' \
--form 'requestID="flight-1001"' \
--form 'transactionID="TRV261017110002AB12CD34"'

<?php
$ch = curl_init('https://api.gsubz.com/api/flight/orders/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'api' => 'YOUR_API_KEY',
        'requestID' => 'flight-1001',
        'transactionID' => 'TRV261017110002AB12CD34',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("api", "YOUR_API_KEY");
form.append("requestID", "flight-1001");
form.append("transactionID", "TRV261017110002AB12CD34");

const response = await fetch("https://api.gsubz.com/api/flight/orders/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/flight/orders/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "api": "YOUR_API_KEY",
    "requestID": "flight-1001",
    "transactionID": "TRV261017110002AB12CD34",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "orders": [
    {
      "transactionID": "TRV261017110002AB12CD34",
      "requestID": "flight-1001",
      "serviceID": "flight",
      "orderStatus": "completed",
      "tripType": "oneway",
      "origin": "LOS",
      "destination": "ABV",
      "departureDate": "2026-12-01",
      "returnDate": null,
      "airline": "Ibom Air",
      "journeys": [
        { "from": "LOS", "to": "ABV", "departsAt": "2026-12-01T08:00:00", "arrivesAt": "2026-12-01T09:10:00", "duration": "1h10", "stops": 0, "flightNumber": "QI 301", "baggage": "23KG baggage" }
      ],
      "passengers": [
        { "type": "Adult", "title": "Mr", "firstName": "Ada", "middleName": null, "lastName": "Obi", "gender": "Male", "countryCode": "NG" }
      ],
      "contact": { "email": "[email protected]", "phone": "+2348031234567" },
      "amount": 95000,
      "amountRefunded": 0,
      "amountPaid": 95000,
      "pnr": "ABC123",
      "tickets": [
        { "name": "Ada Obi", "type": "ADT", "ticketNumber": "1234567890123" }
      ],
      "date": "2026-10-17T11:00:02+01:00"
    }
  ]
}

{
  "code": 404,
  "status": "failed",
  "description": "CONTENT_NOT_FOUND",
  "api_response": "No flight booking found for that reference."
}

curl --location 'https://api.gsubz.com/api/store/search/?scope=market&q=wireless+earbuds&page=1' \
--header 'Authorization: Bearer YOUR_API_KEY'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/search/?scope=market&q=wireless+earbuds&page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/store/search/?scope=market&q=wireless+earbuds&page=1", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/search/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "scope": "market",
    "q": "wireless earbuds",
    "page": "1",
}

response = requests.get(url, headers=headers, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18452,
  "scope": "market",
  "amountPaid": 2,
  "initialBalance": 5000,
  "finalBalance": 4998,
  "date": "2026-10-07T11:20:15+01:00",
  "api_response": "Search results.",
  "page": 1,
  "pageSize": 20,
  "count": 2,
  "hasMore": false,
  "items": [
    {
      "id": "682718261723",
      "title": "Wireless Bluetooth Earbuds Noise Cancelling",
      "fullTitle": "Wireless Bluetooth Earbuds Noise Cancelling Headset, Long Battery Life",
      "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fa1.jpg",
      "priceNgn": 4850,
      "sold": 1240,
      "freeShipping": false
    },
    {
      "id": "701442970035",
      "title": "TWS Earbuds Touch Control Charging Case",
      "fullTitle": "TWS Earbuds Touch Control Charging Case",
      "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fb2.jpg",
      "priceNgn": 3600,
      "sold": 310,
      "freeShipping": false
    }
  ]
}

{
  "code": 404,
  "status": "failed",
  "description": "CONTENT_NOT_FOUND",
  "api_response": "No products found. You were not charged.",
  "callID": 18453
}

curl --location 'https://api.gsubz.com/api/store/image-search/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'image_url="https://example.com/photos/earbuds.jpg"'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/image-search/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'image_url' => 'https://example.com/photos/earbuds.jpg',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("image_url", "https://example.com/photos/earbuds.jpg");

const response = await fetch("https://api.gsubz.com/api/store/image-search/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/image-search/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "image_url": "https://example.com/photos/earbuds.jpg",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18455,
  "scope": "market",
  "amountPaid": 4,
  "initialBalance": 4998,
  "finalBalance": 4994,
  "date": "2026-10-07T11:22:40+01:00",
  "api_response": "Image search results.",
  "page": 1,
  "pageSize": 20,
  "count": 1,
  "hasMore": false,
  "items": [
    {
      "id": "682718261723",
      "title": "Wireless Bluetooth Earbuds Noise Cancelling",
      "fullTitle": "Wireless Bluetooth Earbuds Noise Cancelling Headset, Long Battery Life",
      "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fa1.jpg",
      "priceNgn": 4850,
      "sold": 1240,
      "freeShipping": false
    }
  ]
}

{
  "code": 206,
  "status": "failed",
  "description": "INVALID_CONTENT",
  "api_response": "That link is not an image.",
  "callID": 18456
}

curl --location 'https://api.gsubz.com/api/store/product/?id=682718261723' \
--header 'Authorization: Bearer YOUR_API_KEY'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/product/?id=682718261723');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/store/product/?id=682718261723", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/product/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "id": "682718261723",
}

response = requests.get(url, headers=headers, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18460,
  "scope": "market",
  "amountPaid": 2,
  "initialBalance": 4994,
  "finalBalance": 4992,
  "date": "2026-10-07T11:25:03+01:00",
  "api_response": "Product details.",
  "product": {
    "id": "682718261723",
    "title": "Wireless Bluetooth Earbuds Noise Cancelling Headset",
    "media": [
      { "type": "video", "url": "https://video.example.com/earbuds.mp4" },
      { "type": "image", "url": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fa1.jpg" }
    ],
    "priceTiers": [
      { "minQty": 2, "priceNgn": 4850 },
      { "minQty": 100, "priceNgn": 4300 }
    ],
    "minPriceNgn": 4300,
    "maxPriceNgn": 5100,
    "moq": 2,
    "skus": [
      {
        "skuId": "5001",
        "label": "Black / Standard",
        "stock": 120,
        "priceNgn": 4850,
        "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fk1.jpg",
        "weightKg": 0.12,
        "lengthCm": 12,
        "widthCm": 8,
        "heightCm": 4,
        "shippingNgn": { "airFor1Pc": 4276, "airFor5Pcs": 14250, "seaFor1Pc": 990, "seaFor5Pcs": 3300 }
      }
    ],
    "specs": {
      "Battery": "300mAh",
      "Bluetooth": "5.3"
    },
    "description": "",
    "location": "Guangdong Shenzhen",
    "totalSold": 4321,
    "freeShipping": false,
    "supplier": {
      "id": "sp_Q3ZnR2Fh0uJp9mKcT1xYvWbEoLd8sA"
    },
    "shipping": {
      "airRatePerKgNgn": 21000,
      "seaRatePerCbmNgn": 450000,
      "weightsKg": [0.12],
      "volumesCbm": [0.000384],
      "estimated": true,
      "seaOnly": false,
      "flatAirFeePerItemNgn": null,
      "note": "Fees for any mix of quantities: POST /api/store/order/ with preview=true. The shipping fee charged is final."
    }
  }
}

{
  "code": 404,
  "status": "failed",
  "description": "CONTENT_NOT_FOUND",
  "api_response": "Product not found. You were not charged.",
  "callID": 18461
}

curl --location 'https://api.gsubz.com/api/store/supplier/?id=sp_Q3ZnR2Fh0uJp9mKcT1xYvWbEoLd8sA&page=1' \
--header 'Authorization: Bearer YOUR_API_KEY'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/supplier/?id=sp_Q3ZnR2Fh0uJp9mKcT1xYvWbEoLd8sA&page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/store/supplier/?id=sp_Q3ZnR2Fh0uJp9mKcT1xYvWbEoLd8sA&page=1", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/supplier/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "id": "sp_Q3ZnR2Fh0uJp9mKcT1xYvWbEoLd8sA",
    "page": "1",
}

response = requests.get(url, headers=headers, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18470,
  "scope": "market",
  "amountPaid": 2,
  "initialBalance": 4992,
  "finalBalance": 4990,
  "date": "2026-10-07T11:27:30+01:00",
  "api_response": "Supplier products.",
  "page": 1,
  "pageSize": 20,
  "count": 1,
  "hasMore": true,
  "items": [
    {
      "id": "770000000015",
      "title": "Cotton Casual Shirt",
      "fullTitle": "Cotton Casual Shirt Short Sleeve",
      "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fsh1.jpg",
      "priceNgn": 3100,
      "sold": 65,
      "freeShipping": false
    }
  ]
}

{
  "code": 206,
  "status": "failed",
  "description": "INVALID_CONTENT",
  "api_response": "id must be a supplier id from a product (supplier.id).",
  "callID": 18471
}

curl --location 'https://api.gsubz.com/api/store/categories/' \
--header 'Authorization: Bearer YOUR_API_KEY'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/categories/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/store/categories/", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/categories/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
}

response = requests.get(url, headers=headers, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18480,
  "amountPaid": 0,
  "initialBalance": 4990,
  "finalBalance": 4990,
  "date": "2026-10-07T11:30:02+01:00",
  "api_response": "Categories and brands.",
  "categories": [
    {
      "name": "Women's Clothing",
      "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fc1.jpg",
      "children": [
        {
          "name": "Women's T-Shirts",
          "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fc2.jpg",
          "children": []
        },
        {
          "name": "Women's Casual Pants",
          "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fc3.jpg",
          "children": [
            {
              "name": "Casual Pants",
              "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fc4.jpg",
              "children": []
            }
          ]
        }
      ]
    }
  ],
  "brands": [
    {
      "id": 1,
      "name": "Apple",
      "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fapple.jpg",
      "products": 24
    }
  ]
}

curl --location 'https://api.gsubz.com/api/store/order/?action=stations&state=Lagos' \
--header 'Authorization: Bearer YOUR_API_KEY'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/order/?action=stations&state=Lagos');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/store/order/?action=stations&state=Lagos", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/order/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "action": "stations",
    "state": "Lagos",
}

response = requests.get(url, headers=headers, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18490,
  "scope": "stations",
  "amountPaid": 0,
  "initialBalance": 50000,
  "finalBalance": 50000,
  "date": "2026-10-13T10:02:11+01:00",
  "api_response": "Pickup stations.",
  "parcelSizes": {
    "small":  { "maxKg": 4,  "maxCbm": 0.0384 },
    "medium": { "maxKg": 12, "maxCbm": 0.1536 },
    "large":  { "maxKg": null, "maxCbm": null }
  },
  "states": [
    {
      "state": "Lagos",
      "stations": [
        {
          "name": "Ikota",
          "address": "Ikota Shopping Complex, Lekki",
          "landmark": "Near VGC",
          "phone": "08000000001",
          "hours": { "weekdays": "8am - 6pm", "weekends": "9am - 3pm" },
          "map": "https://maps.example.com/ikota",
          "deliveryFee": { "smallNgn": 2400, "mediumNgn": 4200, "largeNgn": 6800, "days": "2-4 days" }
        }
      ]
    }
  ]
}

curl --location 'https://api.gsubz.com/api/store/order/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "reference": "ORDER-10045",
    "items": [
        {
            "product_id": "682718261723",
            "sku_id": "5001",
            "quantity": 2,
            "price": 4850
        }
    ],
    "shipping_method": "air",
    "state": "Lagos",
    "station": "Ikota",
    "first_name": "Ada",
    "last_name": "Obi",
    "phone": "08031234567",
    "preview": true
}'

<?php
$payload = [
    'reference' => 'ORDER-10045',
    'items' => [
        [
            'product_id' => '682718261723',
            'sku_id' => '5001',
            'quantity' => 2,
            'price' => 4850,
        ],
    ],
    'shipping_method' => 'air',
    'state' => 'Lagos',
    'station' => 'Ikota',
    'first_name' => 'Ada',
    'last_name' => 'Obi',
    'phone' => '08031234567',
    'preview' => true,
];

$ch = curl_init('https://api.gsubz.com/api/store/order/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);
$response = curl_exec($ch);
curl_close($ch);

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

const payload = {
    "reference": "ORDER-10045",
    "items": [
        {
            "product_id": "682718261723",
            "sku_id": "5001",
            "quantity": 2,
            "price": 4850
        }
    ],
    "shipping_method": "air",
    "state": "Lagos",
    "station": "Ikota",
    "first_name": "Ada",
    "last_name": "Obi",
    "phone": "08031234567",
    "preview": true
};

const response = await fetch("https://api.gsubz.com/api/store/order/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/order/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "reference": "ORDER-10045",
    "items": [
        {
            "product_id": "682718261723",
            "sku_id": "5001",
            "quantity": 2,
            "price": 4850,
        },
    ],
    "shipping_method": "air",
    "state": "Lagos",
    "station": "Ikota",
    "first_name": "Ada",
    "last_name": "Obi",
    "phone": "08031234567",
    "preview": True,
}

response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18500,
  "scope": "place",
  "amountPaid": 30676,
  "initialBalance": 50000,
  "finalBalance": 19324,
  "date": "2026-10-13T10:05:40+01:00",
  "api_response": "Order placed.",
  "order": {
    "orderId": 5231,
    "reference": "ORDER-10045",
    "dropship": true,
    "createdAt": "2026-10-13T10:05:40+01:00",
    "cancellableUntil": "2026-10-13T12:05:40+01:00",
    "shippingMethod": "air",
    "recipient": { "firstName": "Ada", "lastName": "Obi", "phone": "08031234567" },
    "pickupStation": { "name": "Ikota", "address": "Ikota Shopping Complex, Lekki", "state": "Lagos" },
    "amounts": {
      "itemsNgn": 9700,
      "serviceFeeNgn": 1900,
      "shippingPaidNgn": 16676,
      "shippingDueNgn": 0,
      "deliveryNgn": 2400
    },
    "items": [
      {
        "itemId": 88120,
        "productId": "682718261723",
        "skuId": "5001",
        "title": "Wireless Bluetooth Earbuds Noise Cancelling Headset",
        "variation": "Black / Standard",
        "image": "https://gsubz.com/store/image_proxy.php?url=https%3A%2F%2Fimg.example.com%2Fk1.jpg",
        "quantity": 2,
        "unitPriceNgn": 4850,
        "lineTotalNgn": 9700,
        "serviceFeeNgn": 1900,
        "status": "PAID",
        "shipping": {
          "method": "air",
          "weightKg": null,
          "volumeCbm": null,
          "status": "paid",
          "unitNgn": 8338,
          "totalNgn": 16676,
          "paidNgn": 16676,
          "dueNgn": 0
        },
        "trackingNumber": null,
        "cancellable": true,
        "cancelledAt": null
      }
    ]
  }
}

{
  "code": 406,
  "status": "failed",
  "description": "PRICE_CHANGED",
  "api_response": "The price of 1 item(s) went up. Nothing was charged. Check the new prices and send the order again.",
  "callID": 18501,
  "items": [
    { "product_id": "682718261723", "sku_id": "5001", "expectedPriceNgn": 4850, "currentPriceNgn": 4990 }
  ]
}

curl --location 'https://api.gsubz.com/api/store/order/?order_id=5231&reference=ORDER-10045' \
--header 'Authorization: Bearer YOUR_API_KEY'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/order/?order_id=5231&reference=ORDER-10045');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const response = await fetch("https://api.gsubz.com/api/store/order/?order_id=5231&reference=ORDER-10045", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/order/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "order_id": "5231",
    "reference": "ORDER-10045",
}

response = requests.get(url, headers=headers, params=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18510,
  "scope": "orders",
  "amountPaid": 0,
  "initialBalance": 19324,
  "finalBalance": 19324,
  "date": "2026-10-14T09:00:00+01:00",
  "api_response": "Order details.",
  "order": {
    "orderId": 5231,
    "reference": "ORDER-10045",
    "items": []
  }
}

{
  "code": 404,
  "status": "failed",
  "description": "CONTENT_NOT_FOUND",
  "api_response": "Order not found.",
  "callID": 18511
}

curl --location 'https://api.gsubz.com/api/store/order/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'action="cancel"' \
--form 'order_id="5231"' \
--form 'item_id="88120"'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/order/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'action' => 'cancel',
        'order_id' => '5231',
        'item_id' => '88120',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("action", "cancel");
form.append("order_id", "5231");
form.append("item_id", "88120");

const response = await fetch("https://api.gsubz.com/api/store/order/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/order/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "action": "cancel",
    "order_id": "5231",
    "item_id": "88120",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18520,
  "scope": "cancel",
  "amountPaid": 0,
  "initialBalance": 19324,
  "finalBalance": 50000,
  "date": "2026-10-13T10:40:12+01:00",
  "api_response": "1 item(s) cancelled. ₦30,676.00 was refunded to your wallet.",
  "refundedNgn": 30676,
  "cancelled": [
    { "itemId": 88120, "refundNgn": 30676, "itemNgn": 9700, "serviceFeeNgn": 1900, "shippingNgn": 16676, "deliveryNgn": 2400 }
  ],
  "order": { "orderId": 5231, "reference": "ORDER-10045", "items": [] }
}

{
  "code": 406,
  "status": "failed",
  "description": "CANCEL_NOT_ALLOWED",
  "api_response": "Orders can only be cancelled within 2 hours of ordering.",
  "callID": 18521
}

curl --location 'https://api.gsubz.com/api/store/order/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'action="pay_shipping"' \
--form 'order_id="5231"'

<?php
$ch = curl_init('https://api.gsubz.com/api/store/order/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => [
        'action' => 'pay_shipping',
        'order_id' => '5231',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

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

const form = new FormData();
form.append("action", "pay_shipping");
form.append("order_id", "5231");

const response = await fetch("https://api.gsubz.com/api/store/order/", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.gsubz.com/api/store/order/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "action": "pay_shipping",
    "order_id": "5231",
}

response = requests.post(url, headers=headers, data=payload, timeout=60)
print(response.json())

{
  "code": 200,
  "status": "successful",
  "callID": 18530,
  "scope": "pay_shipping",
  "amountPaid": 4356,
  "initialBalance": 19324,
  "finalBalance": 14968,
  "date": "2026-10-16T14:20:00+01:00",
  "api_response": "Shipping paid for 1 item(s).",
  "paid": [ { "id": 88121, "amount": 4356 } ],
  "order": { "orderId": 5231, "reference": "ORDER-10045", "items": [] }
}

{
  "code": 406,
  "status": "failed",
  "description": "NOTHING_DUE",
  "api_response": "No shipping fee is due on this order right now.",
  "callID": 18531
}