# List email templates and their params

Canonical page: https://docs.ovok.com/api/email/list-email-templates-and-their-params

`GET /v1/email/templates`

Lists every email template a project can map in its email ConceptMap, with the params each one receives. Use it when you write or review a template.

**Auth:** bearer token. The caller must be a Practitioner, an admin or a super admin, or hold the "System Owner" access policy.
**Scope:** none. The list is the same for every project.

## Behaviour

- Each entry has the template `name`, the `audience` (`patient` or `practitioner`), the `params`, a full `example`, and the `syntax` each provider uses to reference a param.
- `audience` tells you whose app the `baseUrl` param points at: the patient app or the practitioner dashboard.
- Every listed param is always sent. A param marked `nullable` is `null` when there is no value.
- A send whose params do not match its template is refused, so a template can rely on every param listed.
- Resend accepts text and numbers only. A list param `x` reaches Resend as `xList`, with one item per line, and a null reaches it as an empty string.
- Entries follow the order of the `TemplateNames` enum.

## Example

```bash
curl -X GET 'https://api.sandbox.ovok.com/v1/email/templates' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk'
```