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, Rental, SMM) and countries. 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
}