Documentation Index

Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt

Use this file to discover all available pages before exploring further.

List OTP Templates

Prev Next

When you need to review or manage your existing OTP templates, this endpoint returns the full list of templates associated with your WhatsApp channel, including locale and status information.

Endpoint and Headers

GET https://verify.useinsider.com/v1/template/list 

This API key is sensitive and should never be used on the front end or mobile SDK; it should only be implemented on the back end.

Visit our Postman collection to test this request.

Headers

Header

Sample Value

Description

X-INS-AUTH-KEY

1a2b3c4d5e6f

This key is required to authorize your request. Refer to API Authentication Tokens to generate your token.

Content-Type

application/json

This header specifies the media type of the resource.

Sample Request

Every request to the request endpoint must include a JSON-formatted request body containing your parameters.

Make sure to replace the sample values in the request header(s) where required before sending your request.

Below is a sample request to retrieve the list of WhatsApp verification templates.

curl --location 'https://verify.useinsider.com/v1/template/list' \
--header 'Content-Type: application/json' \
--header 'x-ins-auth-key: 1a2b3c4d5e6f'

Sample Responses

200 OK

This response indicates that your request was successfully completed.

{
  "templates": {
    "whatsapp": [
      {
        "locale": "en",
        "text": "",
        "templateName": "sample_otp_template_1"
      },
      {
        "locale": "tr",
        "text": "",
        "templateName": "sample_otp_template_2"
      }
    ]
  }
}

401 Unauthorized

{
  "errors": [
    {
      "message": "unauthorized"
    }
  ]
}

429 Too Many Requests

{
  "errors": [
    {
      "message": "rate limit exceeded"
    }
  ]
}

Limitations

  • All functions must be executed with a simple HTTPS GET request.

  • The API Key should be provided as the authorization key in the request header. If the key is incorrect, the operation will not be executed, and an authorization error will be returned in the response.

  • The service is subject to a rate limit of 25 requests per minute to ensure optimal system performance. If you exceed this limit, you will receive an HTTP 429 Too Many Requests response.

The default limit shown here is a standard baseline. If your use case requires higher capacity, feel free to reach out to the Insider One team — we can adjust it to fit your needs.