{"id":17893,"date":"2026-11-18T23:41:05","date_gmt":"2026-11-18T18:11:05","guid":{"rendered":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/"},"modified":"2026-11-19T00:47:07","modified_gmt":"2026-11-18T19:17:07","slug":"dlt-sms-api-guide","status":"publish","type":"post","link":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/","title":{"rendered":"Fast2SMS DLT SMS API: send SMS with your DLT template (route=dlt)"},"content":{"rendered":"<p>The Fast2SMS DLT SMS API sends an SMS from your own approved sender ID, using a DLT template you have already added in DLT Manager. You call one URL, <code>\/dev\/bulkV2<\/code> with <code>route=dlt<\/code>, and pass the sender ID, the template&#8217;s <strong>Message ID<\/strong>, the values for its variables and the mobile numbers. This guide is for developers and business owners who want to send order updates, alerts, reminders or OTPs from their own website, app or software. It covers every parameter, ready code in cURL, PHP, Python, Node.js, Java, C# and Go, the response, the charges and the common errors.<\/p>\n<aside class=\"f2s-cta\" aria-label=\"Get started with Fast2SMS\"><div class=\"f2s-cta__copy\"><strong class=\"f2s-cta__title\">Send your first DLT SMS by API<\/strong><p>Add your DLT template in DLT Manager, copy the Message ID and send from your own sender ID with one API call.<\/p><\/div><div class=\"f2s-cta__actions\"><a class=\"f2s-cta__btn f2s-cta__btn--primary\" href=\"https:\/\/www.fast2sms.com\/\"><span>Sign up free<\/span> <span class=\"f2sh-btn__arrow\" aria-hidden=\"true\">&rarr;<\/span><\/a><a class=\"f2s-cta__btn f2s-cta__btn--ghost\" href=\"https:\/\/www.fast2sms.com\/meet\/\" target=\"_blank\" rel=\"noopener\">Book a free meeting<\/a><\/div><\/aside>\n<h2>Before you start<\/h2>\n<ul>\n<li><strong>DLT registration:<\/strong> your business (entity), sender ID (header) and content template must be approved on a DLT portal.<\/li>\n<li><strong>DLT Manager:<\/strong> the entity, sender ID and content template must be added in Fast2SMS <strong>DLT Manager<\/strong> and show <strong>Approved<\/strong>. The template must be linked to the sender you will use.<\/li>\n<li><strong>API key:<\/strong> from <strong>API Key<\/strong> under UTILITY. <strong>API Access<\/strong> must be switched on.<\/li>\n<li><strong>Wallet balance:<\/strong> enough for the SMS you send. Unlike Quick SMS, the DLT route has no first-recharge rule.<\/li>\n<li><strong>A server:<\/strong> call the API from your backend. Never put the API key in app or browser code.<\/li>\n<\/ul>\n<h2>How the DLT SMS API works<\/h2>\n<p>When you send through <code>route=dlt<\/code>, you do not send the SMS text. You send the <strong>Message ID<\/strong> of a template saved in DLT Manager, plus the values for its <code>{#var#}<\/code> places. Fast2SMS builds the final text from the approved template, so the text always matches what DLT approved. This is the main difference from the DLT Manual route, where you send the full text yourself.<\/p>\n<div class=\"f2s-note\">The <code>message<\/code> parameter takes the short <strong>Message ID<\/strong> shown on the template card in DLT Manager (for example 10001). It does not take the 19-digit DLT Content Template ID. Passing the 19-digit ID is the most common reason for <a href=\"\/help\/error-424-invalid-message-id\/\">error 424<\/a>.<\/div>\n<h2>Endpoint and authentication<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<tbody>\n<tr>\n<td>URL<\/td>\n<td><code>https:\/\/www.fast2sms.com\/dev\/bulkV2<\/code><\/td>\n<\/tr>\n<tr>\n<td>Method<\/td>\n<td>POST (JSON, form-urlencoded or multipart) or GET with query parameters<\/td>\n<\/tr>\n<tr>\n<td>Header<\/td>\n<td><code>authorization: YOUR_API_KEY<\/code><\/td>\n<\/tr>\n<tr>\n<td>Route<\/td>\n<td><code>route=dlt<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>Send the key in the <code>authorization<\/code> header. The API also reads an <code>authorization<\/code> query parameter, but only use that in no-code tools that cannot set headers, because full URLs end up in server and proxy logs.<\/p>\n<h2>Parameters<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th>Required<\/th>\n<th>Rules<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>route<\/code><\/td>\n<td>Yes<\/td>\n<td><code>dlt<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>sender_id<\/code><\/td>\n<td>Yes<\/td>\n<td>One of your own approved sender IDs in DLT Manager, in exactly the same case (DEMOTR is not demotr).<\/td>\n<\/tr>\n<tr>\n<td><code>message<\/code><\/td>\n<td>Yes<\/td>\n<td>The Message ID of an approved template that is linked to this sender.<\/td>\n<\/tr>\n<tr>\n<td><code>variables_values<\/code><\/td>\n<td>If the template has variables<\/td>\n<td>Values separated by <code>|<\/code>, one per <code>{#var#}<\/code>, in the same order as in the template. Each value is cut to 40 characters.<\/td>\n<\/tr>\n<tr>\n<td><code>numbers<\/code><\/td>\n<td>Yes<\/td>\n<td>10-digit Indian mobile numbers, separated by commas. A leading 91 is removed.<\/td>\n<\/tr>\n<tr>\n<td><code>schedule_time<\/code><\/td>\n<td>No<\/td>\n<td>Send later. A future time as <code>DD-MM-YYYY-HH-MM<\/code> (IST) or a Unix timestamp.<\/td>\n<\/tr>\n<tr>\n<td><code>sms_details<\/code><\/td>\n<td>No<\/td>\n<td><code>1<\/code> adds character count, SMS parts, rate, valid and invalid numbers and amount to the response.<\/td>\n<\/tr>\n<tr>\n<td><code>udf1<\/code>, <code>udf2<\/code>, <code>udf3<\/code><\/td>\n<td>No<\/td>\n<td>Your own reference text, for example an order ID. Stored with the SMS and returned in webhooks.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>You do not need to send a language. Fast2SMS detects it from the template text. A <code>flash<\/code> parameter is ignored.<\/p>\n<h2>Send your first DLT SMS<\/h2>\n<ol class=\"f2s-steps\">\n<li>\n<h3>Find the Message ID and sender ID<\/h3>\n<p>Open the SMS app, then <strong>DLT Manager<\/strong> and <strong>Content Template<\/strong>. Each approved template card shows its <strong>Message ID<\/strong>, the linked <strong>Sender ID<\/strong>, the masked Template ID and the Entity. Click the copy icon next to the Message ID.<\/p>\n<figure class=\"f2s-shot\"><img src=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/sms-dlt-template-list-hd-5-scaled.webp\" width=\"1440\" height=\"900\" loading=\"lazy\" decoding=\"async\" alt=\"Content Template page in DLT Manager with approved template cards showing Message ID, Sender ID, Template ID and Entity\"><figcaption>The Message ID on the card is the value for the message parameter.<\/figcaption><\/figure>\n<\/li>\n<li>\n<h3>Copy the sample code (optional)<\/h3>\n<p>Click <strong>Sample Code<\/strong> on the card. Choose cURL, PHP, Node.js or Python. The snippet already has your sender ID, the Message ID and <code>route=dlt<\/code>. Replace the variable values and the number.<\/p>\n<figure class=\"f2s-shot\"><img src=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/sms-dlt-template-sample-code-hd-3-scaled.webp\" width=\"1440\" height=\"900\" loading=\"lazy\" decoding=\"async\" alt=\"Sample Code window with a cURL request to dev\/bulkV2 using sender_id DEMOTR, message 10001, route dlt, numbers and variables_values\"><figcaption>Sample Code fills in the sender ID and Message ID for you.<\/figcaption><\/figure>\n<\/li>\n<li>\n<h3>Copy your API key<\/h3>\n<p>Go to <strong>API Key<\/strong>. Click <strong>View<\/strong>, enter the OTP sent to your account mobile and copy the key. Keep <strong>API Access<\/strong> switched on.<\/p>\n<figure class=\"f2s-shot\"><img src=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/api-key-hd-4-scaled.webp\" width=\"1440\" height=\"900\" loading=\"lazy\" decoding=\"async\" alt=\"API Key page with masked Authorization Key, View and Reset buttons and the API Access switch on\"><figcaption>Store the key in your server settings, not in your code repository.<\/figcaption><\/figure>\n<\/li>\n<li>\n<h3>Send the request and save the request ID<\/h3>\n<p>Run one of the code samples below. A good reply has <code>\"return\": true<\/code> and a <code>request_id<\/code> that starts with S. Save it. You need it to check delivery.<\/p>\n<\/li>\n<li>\n<h3>Check the call in API Logs<\/h3>\n<p>Every call made with your key appears in <strong>API Logs<\/strong> for 7 days, with the endpoint, HTTP code, response and your server IP. Delivery status per number is in <strong>Delivery Report<\/strong>.<\/p>\n<figure class=\"f2s-shot\"><img src=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/api-logs-hd-scaled.webp\" width=\"1440\" height=\"900\" loading=\"lazy\" decoding=\"async\" alt=\"API Logs list with a BULKV2 GET row showing SMS sent successfully and HTTP 200\"><figcaption>A successful bulkV2 call in API Logs.<\/figcaption><\/figure>\n<\/li>\n<\/ol>\n<h2>Code examples<\/h2>\n<p>All examples use the same template: Message ID 10001 on sender DEMOTR, with the text &#8220;Dear {#var#}, your order {#var#} of Rs.{#var#} is confirmed and will be delivered by {#var#}. &#8211; Demo Traders&#8221;. Use your own sender ID, Message ID and values.<\/p>\n<h3>cURL (POST JSON)<\/h3>\n<pre><code class=\"language-bash\">curl -X POST \"https:\/\/www.fast2sms.com\/dev\/bulkV2\" \\\n  -H \"authorization: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\"route\":\"dlt\",\"sender_id\":\"DEMOTR\",\"message\":\"10001\",\"variables_values\":\"Rahul|DT10458|1240|21 Nov\",\"numbers\":\"9999999999\"}'<\/code><\/pre>\n<h3>cURL (GET)<\/h3>\n<p><code>--data-urlencode<\/code> takes care of the spaces and <code>|<\/code> signs in the values.<\/p>\n<pre><code class=\"language-bash\">curl -G \"https:\/\/www.fast2sms.com\/dev\/bulkV2\" \\\n  -H \"authorization: YOUR_API_KEY\" \\\n  --data-urlencode \"route=dlt\" \\\n  --data-urlencode \"sender_id=DEMOTR\" \\\n  --data-urlencode \"message=10001\" \\\n  --data-urlencode \"variables_values=Rahul|DT10458|1240|21 Nov\" \\\n  --data-urlencode \"numbers=9999999999\"<\/code><\/pre>\n<h3>PHP<\/h3>\n<pre><code class=\"language-php\">&lt;?php\n$payload = [\n    'route'            =&gt; 'dlt',\n    'sender_id'        =&gt; 'DEMOTR',\n    'message'          =&gt; '10001',\n    'variables_values' =&gt; 'Rahul|DT10458|1240|21 Nov',\n    'numbers'          =&gt; '9999999999',\n];\n\n$ch = curl_init('https:\/\/www.fast2sms.com\/dev\/bulkV2');\ncurl_setopt_array($ch, [\n    CURLOPT_POST           =&gt; true,\n    CURLOPT_RETURNTRANSFER =&gt; true,\n    CURLOPT_TIMEOUT        =&gt; 20,\n    CURLOPT_HTTPHEADER     =&gt; [\n        'authorization: YOUR_API_KEY',\n        'Content-Type: application\/json',\n    ],\n    CURLOPT_POSTFIELDS     =&gt; json_encode($payload),\n]);\n$body = curl_exec($ch);\ncurl_close($ch);\n\n$res = json_decode($body, true);\nif (&#33;empty($res['return'])) {\n    echo 'Sent. Request ID: ' . $res['request_id'];\n} else {\n    echo 'Failed: ' . ($res['status_code'] ?? '') . ' ' . json_encode($res['message'] ?? 'no response');\n}<\/code><\/pre>\n<h3>Python<\/h3>\n<pre><code class=\"language-python\">import requests\n\nAPI_KEY = \"YOUR_API_KEY\"\n\npayload = {\n    \"route\": \"dlt\",\n    \"sender_id\": \"DEMOTR\",\n    \"message\": \"10001\",\n    \"variables_values\": \"Rahul|DT10458|1240|21 Nov\",\n    \"numbers\": \"9999999999\",\n}\n\nr = requests.post(\n    \"https:\/\/www.fast2sms.com\/dev\/bulkV2\",\n    headers={\"authorization\": API_KEY},\n    json=payload,\n    timeout=20,\n)\ndata = r.json()\nif data.get(\"return\"):\n    print(\"Sent. Request ID:\", data[\"request_id\"])\nelse:\n    print(\"Failed:\", data.get(\"status_code\"), data.get(\"message\"))<\/code><\/pre>\n<p>For GET, use <code>requests.get(url, headers=..., params=payload)<\/code>. The library encodes the values for you.<\/p>\n<h3>Node.js<\/h3>\n<p>Node.js 18 and later have <code>fetch<\/code> built in.<\/p>\n<pre><code class=\"language-javascript\">const API_KEY = \"YOUR_API_KEY\";\n\nasync function sendDltSms() {\n  const res = await fetch(\"https:\/\/www.fast2sms.com\/dev\/bulkV2\", {\n    method: \"POST\",\n    headers: { authorization: API_KEY, \"Content-Type\": \"application\/json\" },\n    body: JSON.stringify({\n      route: \"dlt\",\n      sender_id: \"DEMOTR\",\n      message: \"10001\",\n      variables_values: \"Rahul|DT10458|1240|21 Nov\",\n      numbers: \"9999999999\",\n    }),\n  });\n  const data = await res.json();\n  if (data.return) return data.request_id;\n  throw new Error(`${data.status_code} ${JSON.stringify(data.message)}`);\n}\n\nsendDltSms().then(console.log).catch(console.error);<\/code><\/pre>\n<h3>Java<\/h3>\n<p>Uses the HttpClient that comes with Java 11 and later.<\/p>\n<pre><code class=\"language-java\">import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class SendDltSms {\n    public static void main(String[] args) throws Exception {\n        String json = \"{\\\"route\\\":\\\"dlt\\\",\\\"sender_id\\\":\\\"DEMOTR\\\",\\\"message\\\":\\\"10001\\\",\"\n                    + \"\\\"variables_values\\\":\\\"Rahul|DT10458|1240|21 Nov\\\",\\\"numbers\\\":\\\"9999999999\\\"}\";\n\n        HttpRequest request = HttpRequest.newBuilder()\n                .uri(URI.create(\"https:\/\/www.fast2sms.com\/dev\/bulkV2\"))\n                .header(\"authorization\", \"YOUR_API_KEY\")\n                .header(\"Content-Type\", \"application\/json\")\n                .POST(HttpRequest.BodyPublishers.ofString(json))\n                .build();\n\n        HttpResponse&lt;String&gt; response = HttpClient.newHttpClient()\n                .send(request, HttpResponse.BodyHandlers.ofString());\n\n        System.out.println(response.statusCode() + \" \" + response.body());\n    }\n}<\/code><\/pre>\n<h3>C# (.NET)<\/h3>\n<pre><code class=\"language-csharp\">using System;\nusing System.Net.Http;\nusing System.Text;\n\nvar client = new HttpClient();\nvar json = \"{\\\"route\\\":\\\"dlt\\\",\\\"sender_id\\\":\\\"DEMOTR\\\",\\\"message\\\":\\\"10001\\\",\"\n         + \"\\\"variables_values\\\":\\\"Rahul|DT10458|1240|21 Nov\\\",\\\"numbers\\\":\\\"9999999999\\\"}\";\n\nvar request = new HttpRequestMessage(HttpMethod.Post, \"https:\/\/www.fast2sms.com\/dev\/bulkV2\");\nrequest.Headers.TryAddWithoutValidation(\"authorization\", \"YOUR_API_KEY\");\nrequest.Content = new StringContent(json, Encoding.UTF8, \"application\/json\");\n\nvar response = await client.SendAsync(request);\nConsole.WriteLine(await response.Content.ReadAsStringAsync());<\/code><\/pre>\n<h3>Go<\/h3>\n<pre><code class=\"language-go\">package main\n\nimport (\n\t\"bytes\"\n\t\"encoding\/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net\/http\"\n\t\"time\"\n)\n\nfunc main() {\n\tpayload, _ := json.Marshal(map[string]string{\n\t\t\"route\":            \"dlt\",\n\t\t\"sender_id\":        \"DEMOTR\",\n\t\t\"message\":          \"10001\",\n\t\t\"variables_values\": \"Rahul|DT10458|1240|21 Nov\",\n\t\t\"numbers\":          \"9999999999\",\n\t})\n\n\treq, _ := http.NewRequest(\"POST\", \"https:\/\/www.fast2sms.com\/dev\/bulkV2\", bytes.NewReader(payload))\n\treq.Header.Set(\"authorization\", \"YOUR_API_KEY\")\n\treq.Header.Set(\"Content-Type\", \"application\/json\")\n\n\tclient := &amp;http.Client{Timeout: 20 * time.Second}\n\tresp, err := client.Do(req)\n\tif err &#33;= nil {\n\t\tpanic(err)\n\t}\n\tdefer resp.Body.Close()\n\n\tbody, _ := io.ReadAll(resp.Body)\n\tfmt.Println(resp.StatusCode, string(body))\n}<\/code><\/pre>\n<aside class=\"f2s-cta\" aria-label=\"Get started with Fast2SMS\"><div class=\"f2s-cta__copy\"><strong class=\"f2s-cta__title\">Get your DLT templates ready<\/strong><p>Add your entity, sender ID and approved templates in DLT Manager, then send from your own software with the code above.<\/p><\/div><div class=\"f2s-cta__actions\"><a class=\"f2s-cta__btn f2s-cta__btn--primary\" href=\"https:\/\/www.fast2sms.com\/\"><span>Sign up free<\/span> <span class=\"f2sh-btn__arrow\" aria-hidden=\"true\">&rarr;<\/span><\/a><a class=\"f2s-cta__btn f2s-cta__btn--ghost\" href=\"https:\/\/www.fast2sms.com\/meet\/\" target=\"_blank\" rel=\"noopener\">Book a free meeting<\/a><\/div><\/aside>\n<h2>Success response<\/h2>\n<pre><code class=\"language-json\">{\n  \"return\": true,\n  \"request_id\": \"Sa1B2c3D4e5F6g7\",\n  \"message\": [\"SMS sent successfully.\"]\n}<\/code><\/pre>\n<p>Note that <code>message<\/code> is a list, not plain text. &#8220;SMS sent successfully.&#8221; means Fast2SMS accepted the SMS and queued it for the operator. It does not mean the phone has received it. Use the <code>request_id<\/code> to check delivery in <strong>Delivery Report<\/strong> or with a webhook.<\/p>\n<p>You may also see these replies with <code>\"return\": true<\/code>:<\/p>\n<ul>\n<li><code>[\"SMS scheduled successfully.\"]<\/code> when you sent <code>schedule_time<\/code>.<\/li>\n<li><code>[\"After approval, SMS will be sent.\"]<\/code> when the account or message is held for a manual check before sending.<\/li>\n<\/ul>\n<h3>Response with sms_details=1<\/h3>\n<p>Add <code>\"sms_details\": 1<\/code> to see what was counted and charged:<\/p>\n<pre><code class=\"language-json\">\"sms_details\": {\n  \"character_count\": 120,\n  \"per_sms_rate\": \"0.2500\",\n  \"sms_count\": 1,\n  \"sms_language\": \"english\",\n  \"total_valid_number\": 2,\n  \"total_invalid_number\": 0,\n  \"valid_numbers\": [\"9999999999\", \"8888888888\"],\n  \"invalid_numbers\": [],\n  \"amount_debited\": \"0.5000\"\n}<\/code><\/pre>\n<p>The rate and amount in this example are only for illustration. Your rate depends on your plan. See the current rates on the <a href=\"https:\/\/www.fast2sms.com\/bulk-sms-pricing\">bulk SMS pricing page<\/a>.<\/p>\n<h2>Always check &#8220;return&#8221;, not only the HTTP code<\/h2>\n<p>Read the <code>return<\/code> field on every reply. A low wallet balance can come back with HTTP 200 and <code>\"return\": false<\/code> (status_code 416). If your code only checks for HTTP 200, it will think the SMS went out when it did not.<\/p>\n<h2>Common errors and fixes<\/h2>\n<p>Errors look like <code>{\"return\":false,\"status_code\":424,\"message\":\"...\"}<\/code>. The HTTP status is 400 unless shown otherwise.<\/p>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>status_code<\/th>\n<th>message<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><a href=\"\/help\/error-412-invalid-authentication\/\">412<\/a> (HTTP 401)<\/td>\n<td>Invalid Authentication, Check Authorization Key<\/td>\n<td>The key is missing, wrong or was reset. Copy it again from <strong>API Key<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/help\/error-413-key-disabled\/\">413<\/a> (HTTP 401)<\/td>\n<td>Invalid Authentication, Authorization Key Disabled<\/td>\n<td>Turn <strong>API Access<\/strong> on.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/help\/error-414-ip-blacklisted\/\">414<\/a> (HTTP 401)<\/td>\n<td>IP is blacklisted from Dev API section<\/td>\n<td>API Security is on. Add your server&#8217;s public IP in <strong>API Security<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td>405<\/td>\n<td>Numbers Missing<\/td>\n<td>Add the <code>numbers<\/code> parameter.<\/td>\n<\/tr>\n<tr>\n<td>406<\/td>\n<td>Invalid Sender ID<\/td>\n<td>The sender is not your approved sender, or the case is different. Copy it from DLT Manager.<\/td>\n<\/tr>\n<tr>\n<td>411<\/td>\n<td>Invalid Numbers<\/td>\n<td>Every number was invalid. Send 10-digit Indian mobiles that start with 6, 7, 8 or 9.<\/td>\n<\/tr>\n<tr>\n<td>416<\/td>\n<td>You don&#8217;t have sufficient wallet balance<\/td>\n<td>Add money to your wallet.<\/td>\n<\/tr>\n<tr>\n<td>424<\/td>\n<td>Invalid Message ID (or Template, Entity ID)<\/td>\n<td>Use the Message ID, not the 19-digit Template ID, and make sure the template is linked to that sender.<\/td>\n<\/tr>\n<tr>\n<td>424 (HTTP 401)<\/td>\n<td>Invalid Schedule Date &amp; Time&#8230;<\/td>\n<td><code>schedule_time<\/code> is in the wrong format or in the past.<\/td>\n<\/tr>\n<tr>\n<td>425<\/td>\n<td>Invalid Template<\/td>\n<td>The template is not approved. Check its status in DLT Manager.<\/td>\n<\/tr>\n<tr>\n<td>426<\/td>\n<td>Invalid link used in variables<\/td>\n<td>A variable starts with a Fast2SMS short link that is not yours or not approved.<\/td>\n<\/tr>\n<tr>\n<td>429<\/td>\n<td>Invalid characters in &#8230; The text is not valid UTF-8<\/td>\n<td>Send UTF-8 text and URL-encode GET values. Nothing was sent or charged.<\/td>\n<\/tr>\n<tr>\n<td>500<\/td>\n<td>Entity blocked \/ Content template blocked \/ Sender id blocked<\/td>\n<td>The DLT record is on the block list. Contact support.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>For every error code, open <strong>API Documentation<\/strong> from the <strong>API Key<\/strong> page. To see exactly what your server sent, open the call in <strong>API Logs<\/strong> and click <strong>View Details<\/strong>.<\/p>\n<h2>Charges, timing and delivery<\/h2>\n<ul>\n<li><strong>Cost:<\/strong> your plan rate x valid numbers x SMS parts. English text is 1 part up to 160 characters, 2 parts up to 306 and 3 parts up to 459. Hindi and other Unicode text is 1 part up to 70 characters, 2 up to 133 and 3 up to 199.<\/li>\n<li><strong>When the wallet is charged:<\/strong> when the queued SMS is processed, shortly after the API reply.<\/li>\n<li><strong>Failed numbers:<\/strong> DLT SMS that fail at the operator are not refunded automatically.<\/li>\n<li><strong>Invalid numbers:<\/strong> they are dropped and not charged. You only get <a href=\"\/help\/error-411-invalid-numbers\/\">error 411<\/a> when every number is invalid.<\/li>\n<li><strong>Promotional templates at night:<\/strong> if the template is Service Explicit or Promotional, or the sender is numeric, SMS sent outside roughly 10 AM to 9 PM are held and sent the next morning. Transactional (Service Implicit) templates go out at any time.<\/li>\n<\/ul>\n<h2>Check delivery<\/h2>\n<p>Use one of these:<\/p>\n<ul>\n<li><strong>Delivery Report<\/strong> in the panel. Search by the request ID or mobile number.<\/li>\n<li><strong>Webhook:<\/strong> Fast2SMS posts the delivery status to your URL. Webhooks fire only for SMS sent through the API.<\/li>\n<li><strong>DLR API:<\/strong> <code>GET https:\/\/www.fast2sms.com\/dev\/dlr\/{request_id}<\/code> with your key. It looks back 7 days.<\/li>\n<\/ul>\n<div class=\"f2s-note\">Pick one method, webhook or DLR polling. Polling the DLR API can stop the webhook from sending those same rows.<\/div>\n<section class=\"f2s-faq\">\n<h2>Frequently asked questions<\/h2>\n<h3>Is the Message ID the same as the DLT Template ID?<\/h3>\n<p>No. The Message ID is a short number Fast2SMS gives each template in DLT Manager. The DLT Template ID is the 19-digit ID from the DLT portal. The DLT SMS API needs the Message ID.<\/p>\n<h3>Can I send to many numbers in one call?<\/h3>\n<p>Yes. Put the numbers in <code>numbers<\/code>, separated by commas. Every number gets the same text. To send different text to different numbers in one call, use <code>\/dev\/custom<\/code>.<\/p>\n<h3>Do I need to send the full SMS text?<\/h3>\n<p>No. On <code>route=dlt<\/code> you send only the Message ID and the variable values. If you want to send the full text with your Entity ID and Template ID, use the DLT Manual route.<\/p>\n<h3>Why is my variable value cut short?<\/h3>\n<p>Each value in <code>variables_values<\/code> is cut to 40 characters. Keep values short, or split long text across two variables in your DLT template.<\/p>\n<h3>Can I use GET instead of POST?<\/h3>\n<p>Yes, both work with the same parameters. POST with JSON is cleaner. With GET, URL-encode every value.<\/p>\n<h3>Can I send OTPs with the DLT SMS API?<\/h3>\n<p>Yes. Use your own approved OTP template and put the code your app made in <code>variables_values<\/code>. Your app then checks the code itself. Smart OTP is the easier choice if you want Fast2SMS to create and verify the code.<\/p>\n<h3>Is there a limit on how many numbers I can send in one request?<\/h3>\n<p>No fixed maximum is published. For very large lists, send in smaller batches so that a network error or timeout does not affect the whole list.<\/p>\n<h3>Does the API support Hindi SMS?<\/h3>\n<p>Yes. If your approved template is in Hindi, the language is detected and the SMS is counted as Unicode.<\/p>\n<\/section>\n<aside class=\"f2s-cta\" aria-label=\"Get started with Fast2SMS\"><div class=\"f2s-cta__copy\"><strong class=\"f2s-cta__title\">Start sending DLT SMS from your app<\/strong><p>Sign up, add your DLT templates and send order updates, alerts and OTPs from your own sender ID.<\/p><\/div><div class=\"f2s-cta__actions\"><a class=\"f2s-cta__btn f2s-cta__btn--primary\" href=\"https:\/\/www.fast2sms.com\/\"><span>Sign up free<\/span> <span class=\"f2sh-btn__arrow\" aria-hidden=\"true\">&rarr;<\/span><\/a><a class=\"f2s-cta__btn f2s-cta__btn--ghost\" href=\"https:\/\/www.fast2sms.com\/meet\/\" target=\"_blank\" rel=\"noopener\">Book a free meeting<\/a><\/div><\/aside>\n<h2>Related guides<\/h2>\n<ul>\n<li><a href=\"\/help\/dlt-manager-entity-sender-template-guide\/\">DLT Manager: add your entity, sender ID and content templates<\/a><\/li>\n<li><a href=\"\/help\/how-to-send-dlt-sms-from-fast2sms-panel\/\">How to send DLT SMS from the Fast2SMS panel<\/a><\/li>\n<li><a href=\"\/help\/fast2sms-webhooks-setup-delivery-reports\/\">Webhooks in Fast2SMS: get delivery reports on your own URL<\/a><\/li>\n<li><a href=\"\/help\/sms-delivery-report-status-meaning\/\">SMS delivery report in Fast2SMS: every status explained<\/a><\/li>\n<li><a href=\"https:\/\/www.fast2sms.com\/help\/what-is-entity-id-sender-id-and-content-template-id-in-dlt-bulk-sms\/\">What is Entity ID, Sender ID and Content Template ID<\/a><\/li>\n<li><a href=\"https:\/\/www.fast2sms.com\/bulk-sms\">Fast2SMS Bulk SMS<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>The Fast2SMS DLT SMS API sends an SMS from your own approved sender ID, using a DLT template you have already added in DLT Manager. You call one URL, \/dev\/bulkV2 with route=dlt, and pass the sender ID, the template&#8217;s Message ID, the values for its variables and the mobile numbers. This guide is for developers [&hellip;]<\/p>\n","protected":false},"featured_media":17888,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4,13,30],"tags":[],"class_list":["post-17893","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-api","category-bulk-sms","category-dlt"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>DLT SMS API: Send SMS with Code Examples | Fast2SMS<\/title>\n<meta name=\"description\" content=\"Send SMS from your own sender with the Fast2SMS DLT SMS API. Parameters, Message ID, code in PHP, Python, Node.js, Java, C#, Go, cURL, errors and charges.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"DLT SMS API: Send SMS with Code Examples | Fast2SMS\" \/>\n<meta property=\"og:description\" content=\"Send SMS from your own sender with the Fast2SMS DLT SMS API. Parameters, Message ID, code in PHP, Python, Node.js, Java, C#, Go, cURL, errors and charges.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/\" \/>\n<meta property=\"og:site_name\" content=\"Fast2SMS\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/Fast2SMS\/\" \/>\n<meta property=\"article:published_time\" content=\"2026-11-18T18:11:05+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-11-18T19:17:07+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/sms-dlt-template-list-hd-5-scaled.webp\" \/>\n\t<meta property=\"og:image:width\" content=\"2560\" \/>\n\t<meta property=\"og:image:height\" content=\"1600\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/webp\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@fast2sms\" \/>\n<meta name=\"twitter:site\" content=\"@fast2sms\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/\"},\"author\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#organization\"},\"headline\":\"Fast2SMS DLT SMS API: send SMS with your DLT template (route=dlt)\",\"datePublished\":\"2026-11-18T18:11:05+00:00\",\"dateModified\":\"2026-11-18T19:17:07+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/\"},\"wordCount\":1886,\"publisher\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/sms-dlt-template-list-hd-5-scaled.webp\",\"articleSection\":[\"API\",\"Bulk SMS\",\"DLT\"],\"inLanguage\":\"en-IN\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/\",\"name\":\"DLT SMS API: Send SMS with Code Examples | Fast2SMS\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/sms-dlt-template-list-hd-5-scaled.webp\",\"datePublished\":\"2026-11-18T18:11:05+00:00\",\"dateModified\":\"2026-11-18T19:17:07+00:00\",\"description\":\"Send SMS from your own sender with the Fast2SMS DLT SMS API. Parameters, Message ID, code in PHP, Python, Node.js, Java, C#, Go, cURL, errors and charges.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/#breadcrumb\"},\"inLanguage\":\"en-IN\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-IN\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/sms-dlt-template-list-hd-5-scaled.webp\",\"contentUrl\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/sms-dlt-template-list-hd-5-scaled.webp\",\"width\":2560,\"height\":1600,\"caption\":\"Content Template page in DLT Manager with approved template cards showing Message ID, Sender ID, Template ID and Entity\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/dlt-sms-api-guide\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API\",\"item\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/api\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Fast2SMS DLT SMS API: send SMS with your DLT template (route=dlt)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/#website\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/\",\"name\":\"Fast2SMS\",\"description\":\"Help\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#organization\"},\"inLanguage\":\"en-IN\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#organization\",\"name\":\"Fast2SMS\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#logo\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/Fast2SMS.png\",\"contentUrl\":\"https:\\\/\\\/www.fast2sms.com\\\/Fast2SMS.png\",\"caption\":\"Fast2SMS\"},\"image\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#logo\"},\"email\":\"support@fast2sms.com\",\"telephone\":\"+91-6262778822\",\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/Fast2SMS\",\"https:\\\/\\\/www.instagram.com\\\/fast2sms\",\"https:\\\/\\\/x.com\\\/fast2sms\",\"https:\\\/\\\/www.youtube.com\\\/Fast2SMSofficial\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/fast2sms\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"DLT SMS API: Send SMS with Code Examples | Fast2SMS","description":"Send SMS from your own sender with the Fast2SMS DLT SMS API. Parameters, Message ID, code in PHP, Python, Node.js, Java, C#, Go, cURL, errors and charges.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/","og_locale":"en_US","og_type":"article","og_title":"DLT SMS API: Send SMS with Code Examples | Fast2SMS","og_description":"Send SMS from your own sender with the Fast2SMS DLT SMS API. Parameters, Message ID, code in PHP, Python, Node.js, Java, C#, Go, cURL, errors and charges.","og_url":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/","og_site_name":"Fast2SMS","article_publisher":"https:\/\/www.facebook.com\/Fast2SMS\/","article_published_time":"2026-11-18T18:11:05+00:00","article_modified_time":"2026-11-18T19:17:07+00:00","og_image":[{"width":2560,"height":1600,"url":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/sms-dlt-template-list-hd-5-scaled.webp","type":"image\/webp"}],"twitter_card":"summary_large_image","twitter_creator":"@fast2sms","twitter_site":"@fast2sms","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/#article","isPartOf":{"@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/"},"author":{"@id":"https:\/\/www.fast2sms.com\/#organization"},"headline":"Fast2SMS DLT SMS API: send SMS with your DLT template (route=dlt)","datePublished":"2026-11-18T18:11:05+00:00","dateModified":"2026-11-18T19:17:07+00:00","mainEntityOfPage":{"@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/"},"wordCount":1886,"publisher":{"@id":"https:\/\/www.fast2sms.com\/#organization"},"image":{"@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/sms-dlt-template-list-hd-5-scaled.webp","articleSection":["API","Bulk SMS","DLT"],"inLanguage":"en-IN"},{"@type":"WebPage","@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/","url":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/","name":"DLT SMS API: Send SMS with Code Examples | Fast2SMS","isPartOf":{"@id":"https:\/\/www.fast2sms.com\/help\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/#primaryimage"},"image":{"@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/sms-dlt-template-list-hd-5-scaled.webp","datePublished":"2026-11-18T18:11:05+00:00","dateModified":"2026-11-18T19:17:07+00:00","description":"Send SMS from your own sender with the Fast2SMS DLT SMS API. Parameters, Message ID, code in PHP, Python, Node.js, Java, C#, Go, cURL, errors and charges.","breadcrumb":{"@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/#breadcrumb"},"inLanguage":"en-IN","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/"]}]},{"@type":"ImageObject","inLanguage":"en-IN","@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/#primaryimage","url":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/sms-dlt-template-list-hd-5-scaled.webp","contentUrl":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/sms-dlt-template-list-hd-5-scaled.webp","width":2560,"height":1600,"caption":"Content Template page in DLT Manager with approved template cards showing Message ID, Sender ID, Template ID and Entity"},{"@type":"BreadcrumbList","@id":"https:\/\/www.fast2sms.com\/help\/dlt-sms-api-guide\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.fast2sms.com\/help\/"},{"@type":"ListItem","position":2,"name":"API","item":"https:\/\/www.fast2sms.com\/help\/api\/"},{"@type":"ListItem","position":3,"name":"Fast2SMS DLT SMS API: send SMS with your DLT template (route=dlt)"}]},{"@type":"WebSite","@id":"https:\/\/www.fast2sms.com\/help\/#website","url":"https:\/\/www.fast2sms.com\/help\/","name":"Fast2SMS","description":"Help","publisher":{"@id":"https:\/\/www.fast2sms.com\/#organization"},"inLanguage":"en-IN"},{"@type":"Organization","@id":"https:\/\/www.fast2sms.com\/#organization","name":"Fast2SMS","url":"https:\/\/www.fast2sms.com\/","logo":{"@type":"ImageObject","@id":"https:\/\/www.fast2sms.com\/#logo","url":"https:\/\/www.fast2sms.com\/Fast2SMS.png","contentUrl":"https:\/\/www.fast2sms.com\/Fast2SMS.png","caption":"Fast2SMS"},"image":{"@id":"https:\/\/www.fast2sms.com\/#logo"},"email":"support@fast2sms.com","telephone":"+91-6262778822","sameAs":["https:\/\/www.facebook.com\/Fast2SMS","https:\/\/www.instagram.com\/fast2sms","https:\/\/x.com\/fast2sms","https:\/\/www.youtube.com\/Fast2SMSofficial","https:\/\/www.linkedin.com\/company\/fast2sms"]}]}},"_links":{"self":[{"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/posts\/17893","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/comments?post=17893"}],"version-history":[{"count":1,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/posts\/17893\/revisions"}],"predecessor-version":[{"id":19290,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/posts\/17893\/revisions\/19290"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/media\/17888"}],"wp:attachment":[{"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/media?parent=17893"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/categories?post=17893"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/tags?post=17893"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}