> For the complete documentation index, see [llms.txt](https://docs.channel360.co.za/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.channel360.co.za/api-usage/using-the-channel360-v1.1-api/templates/get-templates.md).

# Get Templates

## **Get All Templates (List Templates)**

Retrieves a full list of all templates for the organization.

<mark style="color:green;">`GET`</mark>  `https://www.channel360.co.za/v1.1/org/{{orgId}}/templates/list`

{% tabs %}
{% tab title="Response Example" %}

```json
 {
        "tags": {
            "head": [],
            "body": [],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "language": "en",
        "name": "dev_test_template",
        "messageTemplateId": "748356241190585",
        "category": "UTILITY",
        "components": [
            {
                "type": "BODY",
                "text": "Hello this is a test.",
                "buttons": []
            }
        ],
        "createdAt": "2025-04-07T09:00:27.933Z",
        "description": "auto-ingested",
        "enabled": false,
        "namespace": "",
        "status": "REJECTED",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 1,
        "id": "67f3942b4dcb08ab2bdcc1b3"
    },
    {
        "tags": {
            "head": [],
            "body": [],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "language": "en",
        "name": "testing_market",
        "messageTemplateId": "1177319604100139",
        "category": "MARKETING",
        "components": [
            {
                "type": "BODY",
                "text": "Hi would we are marketing",
                "buttons": []
            }
        ],
        "createdAt": "2025-04-07T09:00:27.933Z",
        "description": "auto-ingested",
        "enabled": true,
        "namespace": "",
        "status": "APPROVED",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 0,
        "id": "67f3942b4dcb08ab2bdcc1b4"
    },
    {
        "tags": {
            "head": [],
            "body": [
                {
                    "index": 2,
                    "type": "hard-coded",
                    "value": "Dr Banana"
                },
                {
                    "index": 3,
                    "type": "on-campaign-creation",
                    "value": "Date"
                },
                {
                    "index": 7,
                    "type": "hard-coded",
                    "value": "Marinda"
                },
                {
                    "index": 4,
                    "type": "on-campaign-creation",
                    "value": "Date"
                },
                {
                    "index": 6,
                    "type": "hard-coded",
                    "value": "23 Church Street"
                },
                {
                    "index": 8,
                    "type": "subscriber-field",
                    "fields": "firstName"
                },
                {
                    "index": 1,
                    "type": "subscriber-field",
                    "fields": "firstName"
                }
            ],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "language": "en",
        "name": "text_test",
        "messageTemplateId": "347437139873292",
        "category": "UTILITY",
        "components": [
            {
                "type": "BODY",
                "text": "*Appointment Confirmation* 🗓\n\nHi {{1}}! This is a friendly reminder for your appointment with {{2}} on {{3}}. Please arrive at reception 10min before the start of your scheduled time.\n\nDate:       {{4}}\nTime:       {{5}}\nLocation:   {{6}}\nReception:  {{7}}\n\nReply \"C\" to confirm or \"N\" to cancel.\n\nWe look forward to seeing you!\n\nYour {{8}} team! 🖐",
                "buttons": []
            }
        ],
        "createdAt": "2025-04-07T09:00:27.933Z",
        "description": "auto-ingested",
        "enabled": true,
        "namespace": "",
        "status": "APPROVED",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 57,
        "id": "67f3942b4dcb08ab2bdcc1b5"
    },
```

{% endtab %}
{% endtabs %}

## Filter & Query Template List

You can filter templates by **enabled** status & c**onfigured** templates.

<mark style="color:green;">GET</mark>  `https://www.channel360.co.za/v1.1/org/{{orgId}}/templates/list?enabled=true&filter=configured`

{% tabs %}
{% tab title="Response Example" %}

```json
[
    {
        "tags": {
            "head": [],
            "body": [],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "language": "en",
        "name": "testing_market",
        "messageTemplateId": "1177319604100139",
        "category": "MARKETING",
        "components": [
            {
                "type": "BODY",
                "text": "Hi would we are marketing",
                "buttons": []
            }
        ],
        "createdAt": "2025-04-07T09:00:27.933Z",
        "description": "auto-ingested",
        "enabled": true,
        "namespace": "",
        "status": "APPROVED",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 0,
        "id": "67f3942b4dcb08ab2bdcc1b4"
    },
    {
        "tags": {
            "head": [],
            "body": [],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "description": "testing",
        "namespace": "",
        "status": "APPROVED",
        "enabled": true,
        "category": "MARKETING",
        "name": "fuuneral_benifits12",
        "language": "en",
        "components": [
            {
                "type": "BODY",
                "text": "Hi there...we recently chatted via WhatsApp & have an update for you. Please message us back so one of our staff can assist further.\n\nThe Channel Mobile Team - reply STOP to opt out",
                "buttons": []
            },
            {
                "type": "FOOTER",
                "text": "From Channel Mobile Dev",
                "buttons": []
            }
        ],
        "messageTemplateId": "1054568756722750",
        "createdAt": "2025-04-09T07:50:23.272Z",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 0,
        "id": "67f626bf5ee686ffec661cdd"
    },
    {
        "tags": {
            "head": [
                {
                    "document": {
                        "link": "https://channel360-template-tags.s3.af-south-1.amazonaws.com/2025-06-09T08%3A05%3A19.239Z-2025-06-06T12_57_38.357Z-2025-06-05T13_03_52.097Z-2025-06-05T10_11_20.413Z-Clockify_Time_Report_Summary_24_03_2025-30_04_2025%20%283%29%20%282%29.csv",
                        "filename": "2025-06-06T12_57_38.357Z-2025-06-05T13_03_52.097Z-2025-06-05T10_11_20.413Z-Clockify_Time_Report_Summary_24_03_2025-30_04_2025 (3) (2).csv"
                    },
                    "type": "document"
                }
            ],
            "body": [],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "description": "This is a pdf test",
        "namespace": "",
        "status": "APPROVED",
        "enabled": true,
        "category": "MARKETING",
        "name": "pdf_testing_upload",
        "language": "en",
        "components": [
            {
                "type": "HEADER",
                "format": "DOCUMENT",
                "buttons": []
            },
            {
                "type": "BODY",
                "text": "This is a test",
                "buttons": []
            }
        ],
        "messageTemplateId": "608663161605539",
        "createdAt": "2025-06-05T10:09:50.679Z",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 11,
        "id": "68416cee7b8d212c1ec8d486"
    },
    {
        "tags": {
            "head": [
                {
                    "type": "image",
                    "url": "https://channel360-template-tags.s3.af-south-1.amazonaws.com/2025-06-06T10%3A05%3A42.987Z-KFCs-Colonel-Sanders-joins-a-group-of-strippers-in-raunchy-Mothers-Day-video-EliteFranchise.co_.jpg"
                }
            ],
            "body": [],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "description": "This is a test",
        "namespace": "",
        "status": "APPROVED",
        "enabled": true,
        "category": "MARKETING",
        "name": "image_template_123434",
        "language": "en",
        "components": [
            {
                "type": "HEADER",
                "format": "IMAGE",
                "buttons": []
            },
            {
                "type": "BODY",
                "text": "This is a body",
                "buttons": []
            }
        ],
        "messageTemplateId": "890616133239371",
        "createdAt": "2025-06-06T10:05:33.160Z",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 1,
        "id": "6842bd6d7b8d212c1ec8d574"
    }
]
```

{% endtab %}
{% endtabs %}

## Filter by Enabled Only

<mark style="color:green;">`GET`</mark>  `https://www.channel360.co.za/v1.1/org/{{orgId}}/templates/list?enabled=true`

{% tabs %}
{% tab title="Request Example" %}

```json
{
        "tags": {
            "head": [],
            "body": [],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "language": "en",
        "name": "testing_market",
        "messageTemplateId": "1177319604100139",
        "category": "MARKETING",
        "components": [
            {
                "type": "BODY",
                "text": "Hi would we are marketing",
                "buttons": []
            }
        ],
        "createdAt": "2025-04-07T09:00:27.933Z",
        "description": "auto-ingested",
        "enabled": true,
        "namespace": "",
        "status": "APPROVED",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 0,
        "id": "67f3942b4dcb08ab2bdcc1b4"
    },
    {
        "tags": {
            "head": [],
            "body": [
                {
                    "index": 2,
                    "type": "hard-coded",
                    "value": "Dr Banana"
                },
                {
                    "index": 3,
                    "type": "on-campaign-creation",
                    "value": "Date"
                },
                {
                    "index": 7,
                    "type": "hard-coded",
                    "value": "Marinda"
                },
                {
                    "index": 4,
                    "type": "on-campaign-creation",
                    "value": "Date"
                },
                {
                    "index": 6,
                    "type": "hard-coded",
                    "value": "23 Church Street"
                },
                {
                    "index": 8,
                    "type": "subscriber-field",
                    "fields": "firstName"
                },
                {
                    "index": 1,
                    "type": "subscriber-field",
                    "fields": "firstName"
                }
            ],
            "buttons": []
        },
        "organization": "67ea68df674ce7a1b7002b75",
        "language": "en",
        "name": "text_test",
        "messageTemplateId": "347437139873292",
        "category": "UTILITY",
        "components": [
            {
                "type": "BODY",
                "text": "*Appointment Confirmation* 🗓\n\nHi {{1}}! This is a friendly reminder for your appointment with {{2}} on {{3}}. Please arrive at reception 10min before the start of your scheduled time.\n\nDate:       {{4}}\nTime:       {{5}}\nLocation:   {{6}}\nReception:  {{7}}\n\nReply \"C\" to confirm or \"N\" to cancel.\n\nWe look forward to seeing you!\n\nYour {{8}} team! 🖐",
                "buttons": []
            }
        ],
        "createdAt": "2025-04-07T09:00:27.933Z",
        "description": "auto-ingested",
        "enabled": true,
        "namespace": "",
        "status": "APPROVED",
        "updatedAt": "2025-07-17T09:14:58.444Z",
        "version": 57,
        "id": "67f3942b4dcb08ab2bdcc1b5"
    },
```

{% endtab %}
{% endtabs %}

## **Get a Template by Name**

Use this endpoint when you want to retrieve a specific template using its **name**.

**Example:** Getting a template named `test546`.

<mark style="color:green;">`GET`</mark>  `https://www.channel360.co.za/v1.1/org/{{orgId}}/templates/{{templateName}}`

{% tabs %}
{% tab title="Request Example" %}

```json
{
    "tags": {
        "head": [],
        "body": [],
        "buttons": []
    },
    "organization": "67ea68df674ce7a1b7002b75",
    "description": "Testing",
    "namespace": "",
    "status": "APPROVED",
    "enabled": true,
    "category": "MARKETING",
    "name": "test546",
    "language": "en",
    "components": [
        {
            "type": "BODY",
            "text": "hi test",
            "buttons": []
        },
        {
            "type": "FOOTER",
            "text": "none",
            "buttons": []
        }
    ],
    "messageTemplateId": "735730732676124",
    "createdAt": "2025-08-15T09:55:36.439Z",
    "updatedAt": "2025-12-12T05:56:25.807Z",
    "version": 0,
    "id": "689f041844d20982dffdd201"
}
```

{% endtab %}
{% endtabs %}