# Get a template

`GET /v1/templates/{id}`

Fetches a template by its ID, with its review status.

Needs `templates:read`.

## Path parameters

- `id` (string, uuid): The template's ID.

## Example

```sh
curl https://app.soosh.io/v1/templates/2f9a6c1d-5e3b-4a78-8c04-b1d7e5f3a920 \
  -H "Authorization: Bearer $SOOSH_API_KEY"
```

Response 200:

```json
{
  "id": "2f9a6c1d-5e3b-4a78-8c04-b1d7e5f3a920",
  "name": "order_update",
  "language": "en",
  "category": "UTILITY",
  "status": "APPROVED",
  "rejection_reason": null,
  "quality": "GREEN",
  "number_id": "0f6d3c1e-5b7a-4c52-9a55-3f6a2d5c8b10",
  "parameter_format": "positional",
  "header": {
    "format": "TEXT",
    "text": "Order {{1}}"
  },
  "body": "Hi {{1}}, your order {{2}} is on its way.",
  "footer": "Thanks for shopping with us",
  "buttons": [
    {
      "type": "URL",
      "text": "Track",
      "url": "https://example.com/track/{{1}}"
    }
  ],
  "variables": {
    "header": [
      "1"
    ],
    "body": [
      "1",
      "2"
    ],
    "buttons": {
      "0": [
        "1"
      ]
    }
  },
  "created_at": "2026-10-01T06:15:03.774Z",
  "updated_at": "2026-10-01T06:42:19.008Z"
}
```

## Returns

200. The template.

## Errors

Besides the ones every request can get (https://docs.soosh.io/reference/api/errors/):

- 404 `not_found`: There is no template with this ID in your workspace.