Skip to main content
Use this endpoint to fetch all templates registered in your project. The response includes each template’s current approval status, which you can use to determine whether a template is ready for sending.

​
Request

GET https://api.relayos.com.br/v1/templates This endpoint takes no request body or query parameters. 
curl https://api.relayos.com.br/v1/templates \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

A 200 response returns an array of template objects.
​
id
string
Unique template identifier.
​
name
string
Template slug name.
​
language
string
BCP-47 language code for the template (e.g., pt_BR, en_US).
​
status
string
Meta approval status. Possible values: PENDING, APPROVED, REJECTED.
[
  {
    "id": "tpl_01hwxyz123abc",
    "name": "order_confirmation",
    "language": "pt_BR",
    "status": "APPROVED"
  },
  {
    "id": "tpl_01hwxyz456def",
    "name": "welcome_message",
    "language": "en_US",
    "status": "PENDING"
  },
  {
    "id": "tpl_01hwxyz789ghi",
    "name": "promo_summer",
    "language": "pt_BR",
    "status": "REJECTED"
  }
]
Only templates with status APPROVED can be used in POST /v1/messages. Attempting to send with a PENDING or REJECTED template will return a 422 error.