Get your sender IDs and Message IDs by API, and add DLT records (DLT Manager API)

The Fast2SMS DLT Manager API lets your software read your sender IDs and templates, with their Message IDs, and add new entities, sender IDs and content templates without opening the panel. It is useful for resellers, ERP and CRM tools, and anyone who manages many DLT templates. This page covers the list and add endpoints, their fields and replies, the Excel upload option and the rate limits.

Before you start

  • Your API key from API Key, with API Access on.
  • For the add endpoints: your DLT records approved on the DLT portal, and the DLT screenshots or Excel exports hosted at a public URL your server controls.

Endpoints

Endpoint What it does
/dev/dlt_manager?type=sender Lists your sender IDs (rejected ones are left out)
/dev/dlt_manager?type=template Lists your senders, each with its templates and Message IDs
/dev/dlt_manager/add_entity Adds a Principal Entity
/dev/dlt_manager/add_sender Adds one sender ID
/dev/dlt_manager/add_sender_excel Adds sender IDs from a DLT-exported Excel file at a URL
/dev/dlt_manager/add_template Adds one content template
/dev/dlt_manager/add_template_excel Adds templates from a DLT-exported Excel file at a URL

Base URL https://www.fast2sms.com. All of them accept GET or POST, with the key in the authorization header. Use POST for the add endpoints.

List your templates and Message IDs

curl "https://www.fast2sms.com/dev/dlt_manager?type=template" \
  -H "authorization: YOUR_API_KEY"
{
  "success": true,
  "data": [{
    "sender_id": "DEMOTR",
    "entity_id": "1101xxxxxxxxxxxxxxx",
    "entity_name": "Demo Traders",
    "entity_status": "Approved",
    "templates": [{
      "message_id": 10001,
      "message": "Dear {#VAR#}, your order {#VAR#} of Rs.{#VAR#} is confirmed and will be delivered by {#VAR#}. - Demo Traders",
      "status": "Approved",
      "var_count": 4
    }]
  }]
}
Field Use it for
sender_id The sender_id of your DLT SMS request
templates[].message_id The message of your DLT SMS request
templates[].var_count How many values to send in variables_values
templates[].status Approved, Not approved, Rejected or Unknown. Only send Approved templates.
entity_status Whether the entity is approved in Fast2SMS

These are the same records you see in the panel under DLT Manager.

DLT Manager Content Template cards with Message ID, Sender ID, Template ID and Entity, including approved, pending and rejected templates
The API returns the same Message IDs shown on these cards.

Python: cache the list

import requests

r = requests.get("https://www.fast2sms.com/dev/dlt_manager",
                 headers={"authorization": "YOUR_API_KEY"},
                 params={"type": "template"}, timeout=20)

lookup = {}
for s in r.json().get("data", []):
    for t in s.get("templates", []):
        if t["status"] == "Approved":
            lookup[(s["sender_id"], t["message_id"])] = t["var_count"]
print(lookup)

Refresh the cache when you add or delete templates, not before every SMS.

Add DLT records by API

The add endpoints work like the forms in DLT Manager. New records go through the same checks as in the panel. The screenshot fields take a public URL to a file you host (jpg, png, svg, jpeg, gif, pdf, doc or docx).

add_entity

Field Required Notes
entity_id Yes Your DLT Principal Entity ID (longer than 11 digits)
entity_name Yes As registered at DLT
screenshot Yes URL of your DLT entity screenshot
curl -X POST "https://www.fast2sms.com/dev/dlt_manager/add_entity" \
  -H "authorization: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"entity_id":"YOUR_ENTITY_ID","entity_name":"Demo Traders","screenshot":"https://example.com/dlt/entity.png"}'

Reply: {"return":"true","message":"Entity approved"}, or a message that the entity is pending for approval.

add_sender

Field Required Notes
entity_id Yes An entity already in your DLT Manager
sender_id Yes 3 to 6 characters, exactly as approved
screenshot Yes URL of your DLT header screenshot showing it approved
curl -X POST "https://www.fast2sms.com/dev/dlt_manager/add_sender" \
  -H "authorization: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"entity_id":"YOUR_ENTITY_ID","sender_id":"DEMOTR","screenshot":"https://example.com/dlt/header.png"}'

Reply message: “Sender ID is pending for approval”.

add_template

Field Required Notes
entity_id Yes The template’s entity
sender_id Yes A list of one or more senders to link, for example ["DEMOTR"]
template_id Yes The DLT Content Template ID
message_text Yes The approved text with {#var#} for each variable
template_type Yes n = Service Implicit, y = Service Explicit or Promotional
screenshot Yes URL of your DLT template screenshot
curl -X POST "https://www.fast2sms.com/dev/dlt_manager/add_template" \
  -H "authorization: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"entity_id":"YOUR_ENTITY_ID","sender_id":["DEMOTR"],"template_id":"YOUR_TEMPLATE_ID",
       "message_text":"Dear {#var#}, your order {#var#} of Rs.{#var#} is confirmed and will be delivered by {#var#}. - Demo Traders",
       "template_type":"n","screenshot":"https://example.com/dlt/template.png"}'

Reply message: “Content Template is pending for approval.” Once approved, the template gets a Message ID you can read with type=template.

add_sender_excel and add_template_excel

If you have many records, export them from your DLT portal as Excel and host the .xlsx file at a public URL.

Endpoint Fields
add_sender_excel entity_id, sender_excel (URL of the .xlsx file)
add_template_excel entity_id, content_excel (URL of the .xlsx file)
curl -X POST "https://www.fast2sms.com/dev/dlt_manager/add_template_excel" \
  -H "authorization: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"entity_id":"YOUR_ENTITY_ID","content_excel":"https://example.com/dlt/templates.xlsx"}'

Node.js: add a template

const res = await fetch("https://www.fast2sms.com/dev/dlt_manager/add_template", {
  method: "POST",
  headers: { authorization: "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    entity_id: "YOUR_ENTITY_ID",
    sender_id: ["DEMOTR"],
    template_id: "YOUR_TEMPLATE_ID",
    message_text: "Dear {#var#}, your order {#var#} of Rs.{#var#} is confirmed and will be delivered by {#var#}. - Demo Traders",
    template_type: "n",
    screenshot: "https://example.com/dlt/template.png",
  }),
});
console.log(res.status, await res.json());

Rate limits

Endpoint Limit per IP
add_entity 10 per day
add_sender, add_sender_excel 100 per day
add_template, add_template_excel 300 per hour

Over the limit you get HTTP 429 with {"status":false,"message":"Rate limit exceeded.","code":429}. Wait and try again later, or use the Excel endpoints to add many records in one call.

Common problems

  • Entity refused: the Entity ID must be longer than 11 digits, and it cannot already be in your account.
  • Duplicate sender or template: a record that is already approved or pending is not added again.
  • Blocked records: entities, senders or templates on the DLT block list are refused. Contact support.
  • Screenshot link: host the file at a public URL that opens without a login, so it can be fetched and checked.
  • Template not in the list yet: new templates are pending until approved. Check DLT Manager > Content Template.
DLT Manager Entity ID list with approved, pending and rejected entities and a rejection reason
Records added by API appear in DLT Manager with their status.

Frequently asked questions

Can I delete DLT records by API?

No delete endpoint is offered. Delete entities, senders and templates in the panel under DLT Manager.

Are templates added by API approved instantly?

No. Sender IDs and templates are saved as pending and checked first. Entities found on the DLT platform can be approved at once.

Why does type=sender not show some senders?

Rejected senders are left out. Fix the reason and add the sender again.

Can I upload the screenshot file directly?

The API takes a URL to a file you host. In the panel you can upload the file instead.

Which template_type should I use?

Use n for Service Implicit (transactional and service) templates and y for Service Explicit or Promotional ones, as registered at DLT.

Does the list include WhatsApp templates?

No. WhatsApp numbers and templates have their own endpoint, /dev/dlt_manager/whatsapp.