Developer Docs
Developer Documentation
Integrate Robo Call Pakistan APIs in minutes with clear endpoints, webhooks, SDK examples, and sample requests.
API Ready
Automated Calls
Built for Pakistan
Authentication
All requests require an api_key query parameter. For POST endpoints, pass the key in the query string. All requests should use HTTPS and JSON-friendly responses.
Query
api_key=YOUR_KEYProtocol
HTTPSFormat
JSONGET Endpoint
Place a Call
URL
https://corporate.robocall.pk/api/callsCaller
923327472277| Parameter | Type | Status | Description | Example |
|---|---|---|---|---|
| api_key | string | Required | Your API authentication key | [VOICE API KEY] |
| caller_id | string | Required | Recipient phone number with country code | 923327472277 |
| amount | integer | Required | Order / payment amount | 1000 |
| voice_id | integer | Required | Voice template ID for the call | [VOICE ID] |
| key1 | string | Required | Custom key such as order number | 0 |
| key2 | string | Required | Custom key such as year | 0 |
| text1 | string | Required | Company / store name | robo-call-pakistan-corporate |
| text2 | string | Required | Order code or reference | Abc123 |
| text3 | string | Optional | Additional text field | 100 |
| text4 | string | Optional | Additional text field | 0 |
| text5 | string | Optional | Additional text field | 0 |
Sample Request URL
corporate.robocall.pk/api/calls?api_key=[VOICE API KEY]&caller_id=923327472277&amount=1000&voice_id=[VOICE ID]&key1=0&key2=0&text1=robo-call-pakistan-corporate&text2=Abc123&text3=100&text4=0&text5=0Response
200 Success404 Error
{
"status": 200,
"message": "Call placed successfully",
"data": {
"caller_id": "923151231016",
"order_num": "1001",
"order_id": 1,
"amount": 1000,
"voice_id": "YOUR_VOICE_ID",
"text": "abc",
"text1": "hello"
}
}GET Endpoint
Multiple Calls
URL
https://corporate.robocall.pk/api/mutliple_callsSame parameters as /api/calls. Pass multiple phone numbers as comma-separated values in caller_id.
Sample Request URL
corporate.robocall.pk/api/mutliple_calls?api_key=[VOICE API KEY]&caller_id=923327472277,923327472277&amount=1000&voice_id=[VOICE ID]&key1=0&key2=0&text1=robo-call-pakistan-corporate&text2=Abc123&text3=100&text4=0&text5=0Response
200 Success404 Error
{
"status": 200,
"message": "Call placed successfully",
"data": {
"caller_id": "923151231016",
"order_num": "1001",
"order_id": 1,
"amount": 1000,
"voice_id": "YOUR_VOICE_ID",
"text": "abc",
"text1": "hello"
}
}GET Endpoint
Get Call Status
URL
https://corporate.robocall.pk/api/get_call| Parameter | Type | Status | Description | Example |
|---|---|---|---|---|
| api_key | string | Required | Your API authentication key | [VOICE API KEY] |
| call_id | integer | Required | The unique call ID returned when a call was placed | [Call ID] |
Sample Request URL
corporate.robocall.pk/api/get_call?api_key=[VOICE API KEY]&call_id=[Call ID]200 Success404 Error
{
"status": 200,
"call": {
"id": 330594,
"caller_id": "923702129243",
"voice_id": 13,
"amount": 1000,
"status": "answered",
"dtmf_input": "1"
}
}GET Endpoint
Check Balance
URL
https://corporate.robocall.pk/api/check_balance| Parameter | Type | Status | Description | Example |
|---|---|---|---|---|
| api_key | string | Required | Your API authentication key | [VOICE API KEY] |
Sample Request URL
corporate.robocall.pk/api/check_balance?api_key=[VOICE API KEY]200 Response
{
"status": 200,
"balance": 4500,
"currency": "PKR"
}GET Endpoint
Verify API Key
URL
https://corporate.robocall.pk/api/verify-key| Parameter | Type | Status | Description | Example |
|---|---|---|---|---|
| api_key | string | Required | API key to verify | [VOICE API KEY] |
Sample Request URL
corporate.robocall.pk/api/verify-key?api_key=[VOICE API KEY]200 Valid401 Invalid
{
"status": 200,
"valid": true,
"message": "API key is valid"
}Error Codes
| Code | Meaning | Common Cause |
|---|---|---|
| 200 | Success | Request processed successfully |
| 400 | Bad Request | Missing or malformed parameters |
| 401 | Unauthorized | Invalid or missing API key |
| 404 | Not Found | Call ID or resource does not exist |
| 422 | Validation Error | Invalid parameter values |
| 500 | Server Error | Internal issue - please retry later |