Developer API

Integrate our services directly into your application. All requests must be sent to the base URL:

        https://BitraHQ.com/api/v1/
    

Your API Key

Please log in to view your unique API key.

List All Services

GET /services.php

Fetch lists of all available services (OTP Verification (All Countries), Rental (USA Only) and Social Media Boosting. Use the id from these lists in your order requests.

Parameters

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

Success Response

{
    "success": true,
    "otp_services": [
        {"id": "wa", "name": "Whatsapp", "price": 150.00},
        ...
    ],
    "rental_services": [ ... ],
    "smm_services": [ ... ],
    "countries": [
        {"id": "us", "name": "United States"},
        ...
    ]
}

OTP Verifications

POST /otp.php

Order a temporary number to receive an SMS code.

Parameters

Parameter	Required	Description
`api_key`	Yes	Your API key.
`action`	Yes	Must be `getNumber`.
`service_id`	Yes	The Service ID (e.g. 'wa', 'tg') from the `otp_services` list.
`country_id`	Yes	The Country ID (e.g. 'us', 'ng') from the `countries` list.

Success Response

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

Check OTP Status

POST /status.php

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

Parameters

Parameter	Required	Description
`api_key`	Yes	Your API key.
`order_id`	Yes	The `order_id` received from `otp.php` or `rent.php`.

Response: Waiting

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

Response: Success

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

Rent Number

POST /rent.php

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

Parameters

Parameter	Required	Description
`api_key`	Yes	Your API key.
`action`	Yes	Must be `rentNumber`.
`service_id`	Yes	The Service ID from the `rental_services` list.
`duration_value`	No	Number of days/weeks (Default: 1).
`duration_unit`	No	'D' (Days), 'W' (Weeks), or 'M' (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"
}

SMM Services

POST /smm.php

Place an order for Social Media Marketing services (Likes, Followers, etc.).

Parameters

Parameter	Required	Description
`api_key`	Yes	Your API key.
`action`	Yes	Must be `placeOrder`.
`service_id`	Yes	The Service ID from the `smm_services` list.
`link`	Yes	Target URL (Profile/Post link).
`quantity`	Yes	Amount to order.

Success Response

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

Check SMM Order

POST /smm_status.php

Check the progress of an SMM order.

Parameters

Parameter	Required	Description
`api_key`	Yes	Your API key.
`order_id`	Yes	The `order_id` returned by the placeOrder endpoint.

Success Response

{
    "success": true,
    "status": "In Progress",
    "start_count": 120,
    "remains": 500
}