This endpoint is used to fetch SMS templates for sending SMS campaigns.

Users can create SMS templates in the Easify web app. Once a template is approved, it becomes available through this API.

This endpoint retrieves the user’s approved SMS templates for use in SMS campaigns.

The response is paginated. A limit parameter can be included in the request to specify the number of records per page. If not provided, the default value is 10.

There is a rate limit of 60 requests per minute per API token. This limit is shared by all API endpoints except those with their own separate limit (/api/v2/sms/send, /api/v3/sms/send, etc.), so requests to other endpoints also count toward it. If you exceed this limit, you will receive a 429 Too Many Requests status, along with a message indicating when you can try again.

The authenticated user must have access to the SMS feature. Requests made without the proper feature permissions will receive a 490 status code response, indicating that a plan upgrade is required.

Query Parameters

limit integer

Pagination for SMS Templates (Default :10, Max: 50)

Optional

Example Request and Response

Params:

{
  "limit": 2
}

Success Response:

{
  "status": true,
  "message": "SMS Templates",
  "data": [
    {
      "id": 1450,
      "group_name": "Group 01",
      "name": "Template 01",
      "message": "This is test template. Reply STOP to opt-out.",
      "sms_type": "sms",
      "media_url": "",
      "created_at": "08-25-2025 04:40:31 AM"
    },
    {
      "id": 1452,
      "group_name": "Group 01",
      "name": "Template 02",
      "message": "This is test template 2. Reply STOP to opt-out.",
      "sms_type": "sms",
      "media_url": "",
      "created_at": "08-25-2025 04:40:31 AM"
    }
  ],
  "links": {
    "first": "https://api.easify.live/api/v2/sms/templates?page=1",
    "last": "https://api.easify.live/api/v2/sms/templates?page=21",
    "prev": null,
    "next": "https://api.easify.live/api/v2/sms/templates?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 21,
    "links": [
      {
        "url": null,
        "label": "« Previous",
        "active": false
      },
      {
        "url": "https://api.easify.live/api/v2/sms/templates?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "https://api.easify.live/api/v2/sms/templates?page=2",
        "label": "2",
        "active": false
      }
    ],
    "path": "https://api.easify.live/api/v2/sms/templates",
    "per_page": 2,
    "to": 2,
    "total": 42
  }
}

Easify DNC Registry and chat block will not prevent sending SMS; they only block blacklisted numbers

Responses

Case	Status Code	Response
If the user provides an invalid Easify API token or does not pass the Easify API token in the header.	401	`{ "status":false, "message":"Unauthenticated", "errors":[] }`
If the user exceeds the allowed rate limit for requests	429	`{ "status":false, "message":"Too many requests. Try again in 59 seconds", "errors":[] }`
If the user's subscription has ended	402	`{ "status":false,"message":"You need to recharge your account to proceed","errors":[] }`
When the user account is inactive	403	`{ "status": false, "message": "Your account is currently inactive.", "errors": [] }`
If the request comes from an IP address or domain that is not on the account's API whitelist	400	`{ "status": false, "message": "Access denied! Your IP or domain is not whitelisted.[ HostName : ] - [ Ip Address : << YOUR_SERVER_IP >>]", "errors": [] }`

Code Examples

Fetch SMS templates

php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.easify.live/api/v2/sms/templates?limit=2',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer <>',
    'Accept: application/json',
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

async function main() {
  const response = await fetch('https://api.easify.live/api/v2/sms/templates?limit=2', {
    headers: {
      Authorization: 'Bearer <>',
      Accept: 'application/json',
    },
  })

  const data = await response.json()
  console.log(data)
}

main().catch(console.error)

import requests

response = requests.get(
    "https://api.easify.live/api/v2/sms/templates?limit=2",
    headers={
        "Authorization": "Bearer <>",
        "Accept": "application/json",
    },
)

print(response.json())

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SmsTemplates {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.easify.live/api/v2/sms/templates?limit=2"))
                .header("Authorization", "Bearer <>")
                .header("Accept", "application/json")
                .GET()
                .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
                .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;

class SmsTemplates
{
    static async Task Main()
    {
        using var client = new HttpClient();

        var request = new HttpRequestMessage(
            HttpMethod.Get, "https://api.easify.live/api/v2/sms/templates?limit=2");
        request.Headers.Add("Authorization", "Bearer <>");
        request.Headers.Add("Accept", "application/json");

        var response = await client.SendAsync(request);
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.easify.live/api/v2/sms/templates?limit=2", nil)
    req.Header.Set("Authorization", "Bearer <>")
    req.Header.Set("Accept", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

curl "https://api.easify.live/api/v2/sms/templates?limit=2" \
  -H "Authorization: Bearer <>" \
  -H "Accept: application/json"