GET /v1/templates — List Templates

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.

string

Unique template identifier.

string

Template slug name.

string

BCP-47 language code for the template (e.g., pt_BR, en_US).

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.

Messages

Templates

Projects & Keys

GET /v1/templates — List Templates

Request

Response

​Request

​Response

Request

Response