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.

Queryapi_key=YOUR_KEY
ProtocolHTTPS
FormatJSON

GET Endpoint

Place a Call

URLhttps://corporate.robocall.pk/api/calls
Caller923327472277
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=0

Response

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

URLhttps://corporate.robocall.pk/api/mutliple_calls

Same 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=0

Response

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

URLhttps://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

URLhttps://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

URLhttps://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