Bulk Shortening with Nested Route | DLT-Compliant SMS API for Bulk Short URLs

Bulk Shortening with Nested Route (DLT-Compliant SMS)

POST /url/bulk-url-shortener-nested-route

If you send SMS campaigns at scale in India, ensuring compliance with DLT (Distributed Ledger Technology) is crucial. The Bulk Shortening with Nested Route API by SPRL helps you create multiple short URLs in one request, while aligning with TRAI’s DLT framework.

This API is ideal for bulk SMS dispatch where every message may include a shortened URL, such as OTP links, tracking URLs, campaign CTAs, or custom user journeys, all fully compliant with DLT-registered templates, sender headers, and routes.

Request Information

Method	POST
Request URL	https://insprl.com/api/url/bulk-url-shortener-nested-route
Authentication	Required How to Generate API keys?

Header Parameters

Parameter	Type	Description
Authorization	String	Use your "CLIENT KEY" for this Parameter

Request Parameters

Parameter	Type	Validate	Description
client_id	String	Required	Use your "CLIENT ID" for this Parameter
urls	Array	Required	Add multiple urls (Up to 1000) which you want to get shorter.
nested_path	String	Required, Max 50 chars, Pattern: ^[a-zA-Z0-9\-_]+$	Nested route to append to the short URL. Only letters, numbers, hyphens, and underscores are allowed.
slug_prefix	String	Optional	Allowed only alpha-numeric characters, underscores, and dashes.
domain	String	Optional	Specify if you want to use custom domain
expiry_date	Date	Optional	Date format: dd-mm-yyyy
response_mode	String	Optional	"plain" (Default) or "along" (Pass the reference key to receive in response)

Response Parameters

Parameter	Type	Description
code	Numeric	Find the code information below under "API Codes"
message	String / Array	As per the request handler
short_urls	Array	List of Shorten URLs

Response Codes

Code	Mode	Type	Description
100	success	String	On Success
101	failed	String	Authorization Error
102	failed	Array	Parameter Validation Error

Request Example (PHP Code)

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://insprl.com/api/url/bulk-url-shortener-nested-route");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: {CLIENT_KEY}'
));
curl_setopt($ch, CURLOPT_POSTFIELDS, 
http_build_query(
array(
   'client_id'	=> '{CLIENT_ID}',
   'urls'	=> ["https://www.google.com","https://www.sunprograms.com"],
   //'urls'	=> {"A1":"https://www.google.com","A2":"https://www.sunprograms.com"}, /*Response Mode: "along" */
   'nested_path' => 'ABCDEF',
   'slug_prefix'	=> 'b1-',
   'domain'	=> 'mydomain.com',
   'expiry_date' => '11-02-2020'
   'response_mode' => 'plain'
)
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close ($ch);

Response Sample

With "response_mode" : "plain"
{
"code": 100,
"message": "success",
"data": {
   "short_urls": ["https://mydomain.com/ABCDEF/sUJIrI","https://mydomain.com/ABCDEF/hg6IrI"],
}
}

With "response_mode" : "along"
{
"code": 100,
"message": "success",
"data": {
   "short_urls": {"A1": "https://mydomain.com/ABCDEF/sUJIrI","A2": "https://mydomain.com/ABCDEF/hg6IrI"},
}
}