Developer Documentation

Corporate Account API Overview

Robo Call Pakistan APIs use HTTPS GET endpoints with an api_key query parameter. This matches the website demo form and the project API settings, where calls are sent through https://portal.robocall.pk/api/calls unless a corporate account endpoint is configured.

Authentication

All public examples authenticate with an api_key query parameter. Keep the key private, store it server-side, and never expose it in public frontend JavaScript.

GET Endpoint

Verify API Key

Sample Request URL

https://corporate.robocall.pk/api/verify-key?api_key=[VOICE API KEY]

Sample Response

{
  "status": 200,
  "valid": true,
  "message": "API key is valid"
}

GET Endpoint

Check Balance

Fetch account balance, username, and per-call pulse rate for the supplied API key.

Sample Request URL

https://corporate.robocall.pk/api/check_balance?api_key=[VOICE API KEY]

Sample Response

{
  "status": 200,
  "data": {
    "balance": "2682.00",
    "username": "demo",
    "call_rate": "5.50"
  }
}

Call rate is shown in per-call pulse units, for example per 30 seconds.

GET Endpoint

Send Robo Call

Initiates a robo call to a specified customer with amount, voice ID, keys, and text values. The demo request form in this theme uses the same endpoint and query format.

Sample Request URL

https://corporate.robocall.pk/api/calls?api_key=[VOICE API KEY]&caller_id=923001234567&amount=1500&voice_id=102&key1=0&key2=0&text1=My%20Store&text2=ORD12345&text3=0&text4=0&text5=0

Sample Response

{
  "status": 200,
  "message": "Call Data inserted successfully",
  "data": {
    "call_id": "dynamicgenerated_number",
    "call_to": "923001234567",
    "amount": 1500,
    "voice_id": 102
  },
  "api_response": "Ok 200"
}

GET Endpoint

Get Call Status

Fetch final or in-progress status of a call using the call ID returned by the send call endpoint.

Sample Request URL

https://corporate.robocall.pk/api/get_call?api_key=[VOICE API KEY]&call_id=20076

Sample Response

{
  "data": {
    "call_id": 20076,
    "call_to": "923001234567",
    "call_status": 2,
    "dtmf": 1,
    "retry": 1,
    "amount": 1500,
    "voice_id": 102,
    "text1": "My Store",
    "text2": "ORD12345",
    "call_charges": "6.90"
  },
  "code": 200,
  "response": "Code Executed Successfully"
}

Call Status Definitions

Retry Logic

• Unanswered calls can be retried automatically based on account settings.
• Retry statuses include initiated, congestion, busy, no answer, hangup, and pushed-to-SIP calls that do not convert within timeout.
• Retry delays can be configured from the Call Settings panel.
• Keep checking the get_call endpoint until a final status is available.

E-Commerce Integrations

Robo Call Pakistan provides ready-to-use integrations for Shopify, WooCommerce, Google Sheets, and custom systems through API.

Support

For API key setup, voice IDs, endpoint access, integrations, or troubleshooting, contact Robo Call Pakistan support.