# メールテンプレートを取得

`GET /v1/email-templates/{family}/{locale}` · 権限 `email-templates:read`

テンプレートのスロット（ファミリーとロケールの組み合わせ）の 1 つのバージョンを返します。既定では最新バージョン、`?version=published` では公開済みのバージョン、`?version=N` では指定した番号のバージョンを返します。`ETag` ヘッダーはスロットの最新バージョンです。[下書きを保存](put.md)するときに `If-Match` として送信してください。

## パスパラメーター

| パラメーター | 説明 |
|---|---|
| `family` | メールファミリー。例: `verify_email` または `email_otp`（[メールテンプレートを一覧表示](list.md)を参照）。 |
| `locale` | ロケールタグ。例: `en` または `de`。 |

## クエリパラメーター

| パラメーター | 説明 |
|---|---|
| `version` | `published`、またはバージョン番号（1 以上）。最新バージョンの場合は省略します。 |

## レスポンス

`200 OK`、`ETag: "3"` 付き

```json
{
  "family": "verify_email",
  "locale": "en",
  "version": 3,
  "status": "draft",
  "subject": "Confirm your email for {{ application.name }}",
  "html": "<p>Hi,</p><p><a href=\"{{ link }}\">Confirm your email</a></p>",
  "text_body": "Confirm your email: {{ link }}",
  "from_name": null,
  "source_version": null,
  "created_at": "2026-10-19T09:00:00Z",
  "published_at": null,
  "latest_version": 3,
  "published_version": 2
}
```

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 404 | `not_found` | ファミリーまたはロケールが不明、スロットにバージョンがない、`published` を指定したが公開されたものがない、またはバージョンが存在しません。 |
| 422 | `validation_failed` | `version` が `published` でも正の数値でもありません。 |
| 401 | `unauthenticated` | 資格情報がない、無効、または取り消されています。 |
| 403 | `insufficient_permissions` | 資格情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間が過ぎてから再試行してください。 |
| 503 | `service_unavailable` | 依存先が一時的に利用できません。`Retry-After` の期間が過ぎてから再試行してください。 |

## 例

```bash
curl "https://api.eu.keenauth.com/v1/email-templates/verify_email/en?version=published" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth email-templates get verify_email en --version published`