Developer API Documentation

Fetch lists of all available services (OTP, Rental, SMM) and countries. Use the id from these lists in your order requests.

{
    "success": true,
    "otp_services": [
        {"id": "wa", "name": "Whatsapp", "price": 150.00},
        {"id": "tg", "name": "Telegram", "price": 130.00}
    ],
    "rental_services": [
        {"id": "wa-rent", "name": "WhatsApp Rental", "price_per_day": 80.00}
    ],
    "smm_services": [
        {"id": "ig-likes", "name": "Instagram Likes", "rate": 0.85}
    ],
    "countries": [
        {"id": "us", "name": "United States", "code": "+1"},
        {"id": "ng", "name": "Nigeria", "code": "+234"}
    ]
}

<?php
$url = 'https://bitrahq.com/api/v1/services.php?api_key=YOUR_API_KEY';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Check the current price and availability of a specific service/country combination before ordering.

Response Example

{
    "success": true,
    "price": 150.00,
    "currency": "NGN"
}

Purchase a temporary number to receive an OTP code.

<?php
$url = 'https://bitrahq.com/api/v1/otp.php';
$data = [
    'api_key' => 'YOUR_API_KEY',
    'action' => 'getNumber',
    'service_id' => 'wa',
    'country_id' => 'us'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

{
    "success": true,
    "message": "Number received",
    "order_id": "808000424",
    "phone_number": "1555019988",
    "charge": 150.00,
    "balance": 4500.00
}

Check the status of an OTP or Rental order to get the SMS code. Poll this every 5-10 seconds.

Success Response (SMS Received)

{
    "success": true,
    "status": "COMPLETED",
    "message": "SMS received.",
    "sms_code": "482910"
}

Waiting Response

{
    "success": false,
    "status": "PENDING_SMS",
    "message": "Waiting for SMS..."
}

Cancel an active order and get a refund if no SMS was received.

<?php
$url = 'https://bitrahq.com/api/v1/update_status.php';
$data = [
    'api_key' => 'YOUR_API_KEY',
    'id' => '808000424',
    'status' => 8
];

// ... Standard cURL Request ...
?>

{
    "status": "success",
    "message": "Order canceled and refunded"
}

Rent a number for a longer duration (Days, Weeks, Months).

Success Response

{
    "success": true,
    "message": "Rental created",
    "order_id": "67890",
    "phone_number": "1555019988",
    "charge": 2500.00,
    "expires_at": "2025-11-30 14:00:00"
}

Place orders for Social Media services.

Response

{
    "success": true,
    "message": "Order placed successfully.",
    "order_id": "5021",
    "charge": 500.00,
    "balance": 3500.00"
}