Skip to main content
GET
/
templates
/
search
curl --request GET \
  --url 'https://api.autosend.com/v1/templates/search?query=welcome&templateType=transactional&page=1&limit=10' \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "templates": [
      {
        "templateId": "A-abc123def456ghi789jk",
        "templateName": "Welcome Email",
        "description": "Welcome email for new users",
        "subject": "Welcome to Our Platform!",
        "previewText": "We're glad to have you on board",
        "templateType": "transactional",
        "builderType": "code",
        "createdAt": "2026-01-15T10:30:00.000Z",
        "updatedAt": "2026-02-20T14:45:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 1,
      "pages": 1
    }
  }
}

curl --request GET \
  --url 'https://api.autosend.com/v1/templates/search?query=welcome&templateType=transactional&page=1&limit=10' \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "templates": [
      {
        "templateId": "A-abc123def456ghi789jk",
        "templateName": "Welcome Email",
        "description": "Welcome email for new users",
        "subject": "Welcome to Our Platform!",
        "previewText": "We're glad to have you on board",
        "templateType": "transactional",
        "builderType": "code",
        "createdAt": "2026-01-15T10:30:00.000Z",
        "updatedAt": "2026-02-20T14:45:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 1,
      "pages": 1
    }
  }
}

​
Authorizations

​
Authorizations
string | header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Query Parameters

​
query
string
Search query string. Searches across template name, subject, and template ID.Example: "welcome"
​
templateType
string
Filter templates by type.Allowed values: transactional, marketingExample: "transactional"
​
templateName
string
Filter by exact template name.Example: "Welcome Email"
​
subject
string
Filter by subject line.Example: "Welcome"
​
templateId
string
Filter by template ID.Example: "A-abc123def456ghi789jk"
​
page
integer
Page number for pagination (starts at 1).Minimum: 1Example: 1
​
limit
integer
Number of results per page.Range: 1 - 100Example: 10
​
sortBy
string
Field to sort results by.Default: "createdAt"Example: "createdAt"

​
Response

Templates search results
​
success
boolean
Indicates if the request was successfulExample: true
​
data
object