Developer API

Integrate BitraHQ services directly into your own platforms. Our robust REST API allows you to automate OTP verification, social media boosting, and number rentals.

Base URL https://bitrahq.com/api/v1/

Your API Key

Keep this private. Include it in the api_key parameter.

List All Services

GET services.php

Fetch detailed lists of all available OTP, Rental, and SMM services along with supported countries. Use the id from these lists for ordering.

Parameter	Type	Required	Description
`api_key`	String	Yes	Your unique API key for authentication.

{
    "success": true,
    "otp_services": [
        {"id": "wa", "name": "Whatsapp", "price": 150.00},
        {"id": "tg", "name": "Telegram", "price": 130.00}
    ]
}

<?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 Price & Availability

POST price.php

Check current price and stock for a specific service and country before ordering.

Parameter	Required	Description
service_id	Yes	e.g., `wa`, `tg`
country_id	Yes	e.g., `us`, `ng`

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

Order OTP Number

POST otp.php

Request a temporary number for OTP verification. Charge is deducted on success.

{
    "success": true,
    "order_id": "808000424",
    "phone_number": "1555019988",
    "charge": 150.00
}

Poll for SMS Code

POST status.php

Retrieve the SMS code for an active order by polling this endpoint.

Success Response

{
    "success": true,
    "status": "COMPLETED",
    "sms_code": "482910"
}

Cancel & Refund

POST update_status.php

Cancel an order if no SMS was received. Refunds the full amount to your balance.

Parameter	Value	Description
status	`8`	Code for Cancellation

Rent Number

POST rent.php

Rent a number for Days, Weeks, or Months.

{
    "success": true,
    "expires_at": "2025-11-30 14:00:00"
}

Place SMM Order

POST smm.php

Submit an order for social media engagement.

Parameter	Required
link	Yes
quantity	Yes