API Documentation

Plain

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

PHP Restful API

If you are going to build your own applications and your requirement is Bulksms , BrandedSMS , Masked SMS and You need a super fast response and better grip in your application then our php Rest API is very advance and good.

Our Docs are such friendly that a normal user can also integrate API with out having deep Developer knowledge. Our Rest api is best choice for international SMS.

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/plain

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$to = "92xxxxxxxxxx";
$from = "Brand";
$message = "Testing SMS";
$url = "https://alipursms.com/plain?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&to=".$to."&from=".urlencode($from)."&message=".urlencode($message)."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$to = "92xxxxxxxxxx";
$from = "Brand";
$message = "Testing SMS";
$url = "https://alipursms.com/plain";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&to=".$to."&from=".urlencode($from)."&message=".urlencode($message).""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

OK : 798149e144b88bbe5255

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
to *	Recepient Mobile Number (Required).
from *	Your company Name/Brand Name like "xyz" Displayed of Recepient mobile (Required).
type	type=unicode FOR unicode SMS (OPTIONAL).
date	dd-mm-YYYY Example:25-02-2014 (OPTIONAL)
time	hh:mm:ss Example:21:30:55 (OPTIONAL)
message *	The Message For Recepient (Required).

Return Response and their Meanings

Return Values
OK	{message_id} - e.g 798149e144b88bbe5255
-1	Your request is incomplete and missing some mandatory parameters.
-2	Invalid Recipient Number.
-3	Sender ID cant Be Greater Than 11 Characters.
-4	The token and secret you supplied is either invalid or disabled or blocked.
-5	Message Length Cant Be exceeded Than 612 Characters.
-6	Balance Error.
-7	SMS Rejected Due to spam Filters.
-8	Too many Recepients are Supplied
-9	Unknow error (contact with Department).
-10	Service Down.
-11	Invalid Date For Schedule.

Note: You can Explod Successfull Result by delemeter Collan ( : ) . First Param for outPut and second to trace Delivery.

Successfull Output Response

OK : 798149e144b88bbe5255

Scheduled SMS For Future Reservation?

Below simple HTTP GET / POST METHOD example is given. Please Click on it to check api interferace
https://alipursms.com/plain?api_token= xxxx&api_secret=xxxx&to=92xxxxxxxxxx&from=Brand&date=21-05-2019&time=21:30:50&message=this+is+plain+api

JSON

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

JSON Output API

Welcome to the REST API. Below, you will find a full listing of all the available endpoints. As we add more endpoints, they will be automatically documented here and available through the Documents.

All requests must be submitted to the base URL. We provides you with an option of a response as a JSON object, or an XML string - you have to choose required response by selecting the appropriate base URL for your request.

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/json

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$to = "92xxxxxxxxxx,92xxxxxxxxxx,92xxxxxxxxxx";
$from = "Brand";
$message = "Testing SMS";
$url = "https://alipursms.com/json?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&to=".$to."&from=".urlencode($from)."&message=".urlencode($message)."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$to = "92xxxxxxxxxx,92xxxxxxxxxx,92xxxxxxxxxx";
$from = "Brand";
$message = "Testing SMS";
$url = "https://alipursms.com/json";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&to=".$to."&from=".urlencode($from)."&message=".urlencode($message).""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

// Multiple Number Response
{"status":1,"type":"text","totalprice":3,"totalgsm":3,"remaincredit":11999991,"messages":[{"status":"OK","messageid":"ddc282453ce3ca74af1f0","gsm":"923001234567"},{"status":"OK","messageid":"78f7e373efffcc9e781f1","gsm":"923331234567"},{"status":"OK","messageid":"928bea94253a7d01ec012","gsm":"923211234567"}]}

//Single Number Response
{"status":1,"type":"text","totalprice":1,"totalgsm":1,"remaincredit":11999990,"messages":[{"status":"OK","messageid":"65ea6cf22818dfe9d2ac0","gsm":"923001234567"}]}

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
to *	Recepient Mobile Numbers (Required).
from *	Your company Name/Brand Name like "xyz" Displayed of Recepient mobile (Required).
type	type=unicode FOR unicode SMS (OPTIONAL).
date	dd-mm-YYYY Example:25-02-2014 (OPTIONAL)
time	hh:mm:ss Example:21:30:55 (OPTIONAL)
message *	The Message For Recepient (Required).

Return Response and their Meanings

Return Values
1	{details}
-1	Your request is incomplete and missing some mandatory parameters.
-2	Invalid Recipient Number.
-3	Sender ID cant Be Greater Than 11 Characters.
-4	The token and secret you supplied is either invalid or disabled or blocked.
-5	Message Length Cant Be exceeded Than 612 Characters.
-6	Balance Error.
-7	SMS Rejected Due to spam Filters.
-8	Too many Recepients are Supplied
-9	Unknow error (contact with Department).
-10	Service Down.
-11	Invalid Date For Schedule.

Successfull Output Response

{"status":1,"type":"text","totalprice":3,"totalgsm":3,"remaincredit":11999991,"messages":[{"status":"OK","messageid":"ddc282453ce3ca74af1f0","gsm":"923001234567"},{"status":"OK","messageid":"78f7e373efffcc9e781f1","gsm":"923331234567"},{"status":"OK","messageid":"928bea94253a7d01ec012","gsm":"923211234567"}]}

Scheduled SMS For Future Reservation?

Below simple HTTP GET / POST METHOD example is given. Please Click on it to check api interferace
https://alipursms.com/json?api_token= xxxx&api_secret=xxxx&to=92xxxxxxxxxx,92xxxxxxxxxx,92xxxxxxxxxx&from=Brand&date=21-05-2019&time=21:30:50&message=this+is+json+api

XML

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

XML API

It is designed to work 24/7. Manages network link failures, service provider failures, and tolerates server reboots. Extremely Easy integration with your existing IT Systems

GREAT PERFORMANCE - provides the highest availability, performance, and security to run most demanding SMS applications. No hardware or software to buy - integration with your system can be easily done by us.

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/xml

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$to = "92xxxxxxxxxx";
$from = "Brand";
$message = "Testing SMS";
$url = "https://alipursms.com/xml?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&to=".$to."&from=".urlencode($from)."&message=".urlencode($message)."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$to = "92xxxxxxxxxx";
$from = "Brand";
$message = "Testing SMS";
$url = "https://alipursms.com/xml";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&to=".$to."&from=".urlencode($from)."&message=".urlencode($message).""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

//Single Number Response
<responce>
	<status>OK</status>
	<messageid>95f671e90c4e8740d9e6</messageid>
	<gsm>923001234567</gsm>
</responce>

// Multiple Number Response
{"status":1,"type":"text","totalprice":3,"totalgsm":3,"remaincredit":11999991,"messages":[{"status":"OK","messageid":"ddc282453ce3ca74af1f0","gsm":"923001234567"},{"status":"OK","messageid":"78f7e373efffcc9e781f1","gsm":"923331234567"},{"status":"OK","messageid":"928bea94253a7d01ec012","gsm":"923211234567"}]}

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
to *	Recepient Mobile Numbers (Required).
from *	Your company Name/Brand Name like "xyz" Displayed of Recepient mobile (Required).
type	type=unicode FOR unicode SMS (OPTIONAL).
date	dd-mm-YYYY Example:25-02-2014 (OPTIONAL)
time	hh:mm:ss Example:21:30:55 (OPTIONAL)
message *	The Message For Recepient (Required).

Return Response and their Meanings

Return Values
1	{details}
-1	Your request is incomplete and missing some mandatory parameters.
-2	Invalid Recipient Number.
-3	Sender ID cant Be Greater Than 11 Characters.
-4	The token and secret you supplied is either invalid or disabled or blocked.
-5	Message Length Cant Be exceeded Than 612 Characters.
-6	Balance Error.
-7	SMS Rejected Due to spam Filters.
-8	Too many Recepients are Supplied
-9	Unknow error (contact with Department).
-10	Service Down.
-11	Invalid Date For Schedule.

Scheduled SMS For Future Reservation?

Below simple HTTP GET / POST METHOD example is given. Please Click on it to check api interferace
https://alipursms.com/xml?api_token= xxxx&api_secret=xxxx&to=92xxxxxxxxxx&from=Brand&date=21-05-2019&time=21:30:50&message=this+is+json+api

Personalized SMS

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

Personalized SMS Output API

Welcome to the REST API. Below, you will find a full listing of all the available endpoints. As we add more endpoints, they will be automatically documented here and available through the Documents.

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/personalized

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$from = "Brand";
$data = array(
    		array("to" => "03341234567", "message" => "testing"),
    		array("to" => "03348090100", "message" => "testing"),
    	);
$data = json_encode($data);

$url = "https://alipursms.com/personalized?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&from=".urlencode($from)."&data=".urlencode($data)."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$from = "Brand";
$data = array(
    		array("to" => "03341234567", "message" => "testing"),
    		array("to" => "03348090100", "message" => "testing"),
    	);
$data = json_encode($data);

$url = "https://alipursms.com/personalized";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&from=".urlencode($from)."&data=".$data.""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

{"status":1,"type":"success","totalgsm":2,"remaincredit":11999987,"cost":"2 SMS","messages":[{"message":"testing","gsm":"03341234567","messageid":"65a2c324e4d906ca4c1e1"},{"message":"testing","gsm":"03341234568","messageid":"304bdb4c09cc3c3c1a4d1"}]}

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
to *	Recepient Mobile Numbers (Required).
from *	Your company Name/Brand Name like "xyz" Displayed of Recepient mobile (Required).
type	type=unicode FOR unicode SMS (OPTIONAL).
date	dd-mm-YYYY Example:25-02-2014 (OPTIONAL)
time	hh:mm:ss Example:21:30:55 (OPTIONAL)
data *	details in json format (Required).

Return Response and their Meanings

Return Values
1	{details}
-1	Your request is incomplete and missing some mandatory parameters.
-2	Invalid Recipient Number.
-3	Sender ID cant Be Greater Than 11 Characters.
-4	The token and secret you supplied is either invalid or disabled or blocked.
-6	Balance Error.
-7	SMS Rejected Due to spam Filters.
-8	Too many Recepients are Supplied
-9	Unknow error (contact with Department).
-10	Service Down.
-11	Invalid Date For Schedule.

Successfull Output Response

{"status":1,"type":"success","totalgsm":2,"remaincredit":11999987,"cost":"2 SMS","messages":[{"message":"testing","gsm":"03341234567","messageid":"65a2c324e4d906ca4c1e1"},{"message":"testing","gsm":"03341234568","messageid":"304bdb4c09cc3c3c1a4d1"}]}

Scheduled SMS For Future Reservation?

Below simple HTTP GET / POST METHOD example is given. Please Click on it to check api interferace
https://alipursms.com/personalized?api_token= xxxx&api_secret=xxxx&to=92xxxxxxxxxx,92xxxxxxxxxx,92xxxxxxxxxx&from=Brand&date=21-05-2019&time=21:30:50&data=[{"to":"03341234567","from":"example","message":"testing"},{"to":"03341234568","from":"example","message":"testing"}]

Voice SMS

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

Voice SMS Output API

Welcome to the REST API. Below, you will find a full listing of all the available endpoints. As we add more endpoints, they will be automatically documented here and available through the Documents.

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/voice-sms

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$to = "92xxxxxxxxxx,92xxxxxxxxxx,92xxxxxxxxxx";
$from = "Brand";
$voice_id = 1;
$url = "https://alipursms.com/voice-sms?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&to=".$to."&from=".urlencode($from)."&voice_id=".$voice_id."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$to = "92xxxxxxxxxx,92xxxxxxxxxx,92xxxxxxxxxx";
$from = "Brand";
$voice_id = 1;
$url = "https://alipursms.com/voice-sms";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&to=".$to."&from=".urlencode($from)."&voice_id=".$voice_id.""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

// Multiple Number Response
{"type":"voice","totalprice":2,"totalgsm":2,"remaincredit":11999997,"messages":[{"status":"OK","messageid":"d4116ef35a6f1919c3010","gsm":"923341234567"},{"status":"OK","messageid":"3a4023fa11a5d880902d1","gsm":"923351234567"}]}

//Single Number Response
OK : 8f84a53fda5ee6d043af

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
to *	Recepient Mobile Numbers (Required).
from *	Your company Name/Brand Name like "xyz" Displayed of Recepient mobile (Required).
voice_id *	Id of approved voice sms (Required).
date	dd-mm-YYYY Example:25-02-2014 (OPTIONAL)
time	hh:mm:ss Example:21:30:55 (OPTIONAL)

Return Response and their Meanings

Return Values
-1	Your request is incomplete and missing some mandatory parameters.
-2	Invalid Recipient Number.
-3	Sender ID cant Be Greater Than 11 Characters.
-4	The token and secret you supplied is either invalid or disabled or blocked.
-6	Balance Error.
-7	SMS Rejected Due to spam Filters.
-8	Too many Recepients are Supplied
-9	Unknow error (contact with Department).
-10	Service Down.
-11	Invalid Date For Schedule.
-14	Either this voice message is invalid or not approved yet.
-15	You donot have permission to send voice message.

Scheduled SMS For Future Reservation?

Below simple HTTP GET / POST METHOD example is given. Please Click on it to check api interferace
https://alipursms.com/voice-sms?api_token= xxxx&api_secret=xxxx&to=92xxxxxxxxxx,92xxxxxxxxxx,92xxxxxxxxxx&from=Brand&date=21-05-2019&time=21:30:50&voice_id=1

Balance Inquiry

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

Balance Inquiry API

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/balance-inquiry

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$url = "https://alipursms.com/balance-inquiry?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$url = "https://alipursms.com/balance-inquiry";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret).""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

{"sms":11999989,"voice_minutes":12000000}

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).

Return Response and their Meanings

Return Values
1	{details}
-1	Your request is incomplete and missing some mandatory parameters.

Delivery Inquiry

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

Delivery Inquiry API

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/delivery

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$messageid = "xxxxxxxxx,xxxxxxxxx";
$url = "https://alipursms.com/delivery?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&messageid=".$messageid."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$messageid = "xxxxxxxxx,xxxxxxxxx";
$url = "https://alipursms.com/delivery";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&messageid=".$messageid.""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

// Multiple ID Response
{"status":1,"delivery":[{"id":"a30913b2ca486c8515ce1","status":"Delivered","gsm":"923341234567","date":"13-01-2019 (06:52:36 PM)"},{"id":"798149e144b88bbe5255","status":"Failed","info":"Pending","gsm":"923341234567"}]}

//Single ID Response
{"status":1,"delivery":{"id":"a30913b2ca486c8515ce1","status":"Delivered","gsm":"923341234567","date":"13-01-2019 (06:52:36 PM)"}}

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
messageid *	Message ID (Required).

Return Response and their Meanings

Return Values
1	{details}
-1	Your request is incomplete and missing some mandatory parameters.
-2	Incorrect messageId.

Voice Request

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

Voice Request Output API

Welcome to the REST API. Below, you will find a full listing of all the available endpoints. As we add more endpoints, they will be automatically documented here and available through the Documents.

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/voice-request

POST
SUCCESS RESPONSE

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$title = "Title of voice sms";
$url = "https://alipursms.com/voice-request";

// For File Upload
$path = "Path of voice sms file";
$curl_file = new \CURLFile(realpath($path));
$parameters = array (
    "api_token" => $api_token ,
    "api_secret" => $api_secret ,
    "title" => $title ,
    "file" => $curl_file ,
);
// End For File Upload

// For Text To Speech
$text_to_speech = "This is text to speech for demo.";
$parameters = array (
    "api_token" => $api_token ,
    "api_secret" => $api_secret ,
    "title" => $title ,
    "text_to_speech" => $text_to_speech ,
);
// End For Text To Speech

set_time_limit(0);
$ch = curl_init(); 
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/4.0 (compatible;)");
curl_setopt($ch, CURLOPT_HTTPHEADER,array("Content-Type: multipart/form-data"));
curl_setopt($ch, CURLOPT_FRESH_CONNECT, 1);
curl_setopt($ch, CURLOPT_FORBID_REUSE, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 100);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
$result = curl_exec ($ch);
curl_close($ch);

echo $response ;

{"type":"success","ID":2}

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
title *	Title of voice (Required).
file *	Voice SMS file (Required).

Return Response and their Meanings

Return Values
1	{details}
-1	Your request is incomplete and missing some mandatory parameters.
-4	The token and secret you supplied is either invalid or disabled or blocked.
-17	Allowed upload file of maximum 10MB size.
-18	Invalid file. File type must be wav, mp3.
-12	File Upload Error.
-27	You dont have enough credit to create voice message.

Voice Status

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

Voice Status Output API

Welcome to the REST API. Below, you will find a full listing of all the available endpoints. As we add more endpoints, they will be automatically documented here and available through the Documents.

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/voice-status

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$voice_id = 1;
$url = "https://alipursms.com/voice-status?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&voice_id=".$voice_id."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$voice_id = 1;
$url = "https://alipursms.com/voice-status";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&voice_id=".$voice_id.""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

//Single ID Response
{"status":1,"voice_id":1,"title":"Voice SMS","status":"Approved"}

//Multiple ID Response
{"status":1,"messages":[{"voice_id":1,"title":"Voice SMS","status":"Approved"},{"voice_id":2,"title":"Voice SMS 2","status":"Approved"}]}

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
voice_id *	Id of voice sms (Required).

Return Response and their Meanings

Return Values
1	{details}
-1	Your request is incomplete and missing some mandatory parameters.
-4	The token and secret you supplied is either invalid or disabled or blocked.
-15	You donot have permission to send voice message.
-16	Invalid voice ID.

Network Lookup

http / Php / json / xml / C# / .NET / java
Delivery Reports / Pre-built Libraries / Readymade SMS Sending Script

Network Lookup Output API

Welcome to the REST API. Below, you will find a full listing of all the available endpoints. As we add more endpoints, they will be automatically documented here and available through the Documents.

All requests are submitted through the HTTP GET / POST Method

Base Url

https://alipursms.com/network-lookup

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$phone_number = "xxxxxxxxxxxx";
$url = "https://alipursms.com/network-lookup?api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&phone_number=".$phone_number."";

$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch); 

echo $response;

<?php

$api_token = "Your API token";
$api_secret = "Your API secret";
$phone_number = "xxxxxxxxxxxx";
$url = "https://alipursms.com/network-lookup";
$parameters = "api_token=".urlencode($api_token)."&api_secret=".urlencode($api_secret)."&phone_number=".$phone_number.""; 

$ch = curl_init();
$timeout  =  30;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
curl_close($ch);

echo $response ;

// Multiple Number Response
{"status":1,"total_numbers":2,"valid_numbers":2,"invalid_numbers":0,"messages":[{"status":"1","phone_number":"923341234567","number":{"valid":1,"international_format":"+92 334 1234567","e164_format":"+923341234567","national_format":"0334 1234567"},"location":{"country":"Pakistan","region":"Pakistan","country_iso":"PK","country_code":"92","timezone":["Asia\/Karachi"]},"network":{"network":"Ufone","mobile_network_code":"08","mobile_country_code":"410","network_code":"41008"}},{"status":"1","phone_number":"923351234567","number":{"valid":1,"international_format":"+92 335 1234567","e164_format":"+923351234567","national_format":"0335 1234567"},"location":{"country":"Pakistan","region":"Pakistan","country_iso":"PK","country_code":"92","timezone":["Asia\/Karachi"]},"network":{"network":"Ufone","mobile_network_code":"08","mobile_country_code":"410","network_code":"41008"}}]}

//Single Number Response
{"status":1,"messages":{"status":"1","phone_number":"923341234567","number":{"valid":1,"international_format":"+92 334 1234567","e164_format":"+923341234567","national_format":"0334 1234567"},"location":{"country":"Pakistan","region":"Pakistan","country_iso":"PK","country_code":"92","timezone":["Asia\/Karachi"]},"network":{"network":"Ufone","mobile_network_code":"08","mobile_country_code":"410","network_code":"41008"}}}

Please Note: All Required Fields are compulsory! Your Request Can Not move Forward without Required Fields

Information About Parameters

Parameters
api_token *	Your API token (Required).
api_secret *	Your API Secret (Required).
phone_number *	Phone number (Required).

Return Response and their Meanings

Return Values
1	{details}
-1	Your request is incomplete and missing some mandatory parameters.
-2	Invalid Phone Number.
-4	The token and secret you supplied is either invalid or disabled or blocked.