List Authentication Templates

Retrieve a paginated list of all approved AUTHENTICATION category templates available for sending OTP and verification codes.

This endpoint only returns templates that are:

Category: AUTHENTICATION

Status: APPROVED

Required Scope: templates:read

Query Parameters

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`per_page`	integer	Items per page (default: 15, max: 100)
`sort`	string	Sort field. Allowed: `template_name`, `created_at`, `language`. Prefix with `-` for descending
`search`	string	Search across `template_name`, `body_data` (partial match)
`q`	string	Alias for `search`
`filter[language]`	string	Filter by language code (e.g., `en`)
`filter[template_name]`	string	Filter by template name

Field	Type	Description
`id`	integer	Internal template record ID
`template_name`	string	Template name identifier
`language`	string	Template language code
`body_text`	string	Template body text (may contain {{1}}, {{2}} placeholders)
`body_params_count`	integer	Number of body parameters required
`header_format`	string	Header type (TEXT, IMAGE, VIDEO, DOCUMENT, NONE)
`header_text`	string\|null	Header text content
`footer_text`	string\|null	Footer text content
`status`	string	Always `APPROVED` (pre-filtered)
`created_at`	string	ISO 8601 timestamp

Discover available OTP/authentication templates

Check parameter requirements before calling /auth/send-otp

Verify template names and languages for your integration

Status	Error Code	Description
401	`UNAUTHORIZED`	Invalid or missing API token
403	`INSUFFICIENT_SCOPE`	Token missing `templates:read` scope
429	`RATE_LIMIT_EXCEEDED`	Too many requests
500	`INTERNAL_ERROR`	Failed to fetch authentication templates

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************