---
title: "List email template variables"
method: GET
path: "/v3/portals/email-templates/variables"
tags: ["Portal Emails"]
---

# List email template variables

`GET /v3/portals/email-templates/variables`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v3/portals/email-templates/variables`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

List email template variables

## Response `200`

Successful response of usable variables for use in portal email templates.

- EmailTemplateVariablesList
  - `data` EmailTemplateVariable[]
    - `name` 'portal_display_name' | 'portal_domain' | 'developer_email' | 'developer_fullname' | 'dev_portal_reply_to' | 'developer_status' | 'api_documentation_url' | 'api_name' | 'api_version' | 'application_name' | 'credential_name' | 'credential_expires_at', required: Enum for available portal email template variables.
    - `description` string, required
    - `scope` EmailTemplateName[], required
    - `example` string, required: Example value of the email template variable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-09-25** `68d43091b84d`: 2 warning
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-18** `f324fb7610e4`: 2 breaking, 17 info
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - …15 more
- **2026-04-01** `fc69b102d709`: 1 warning
  - added the new `developer-invitation` enum value to the `data/items/scope/items/` response property for the response status `200`
- **2026-02-04** `dccf1fb37679`: 4 warning
  - added the new `api-key-expired` enum value to the `data/items/scope/items/` response property for the response status `200`
  - added the new `api-key-expiring-soon` enum value to the `data/items/scope/items/` response property for the response status `200`
  - added the new `credential_expires_at` enum value to the `data/items/name` response property for the response status `200`
  - added the new `credential_name` enum value to the `data/items/name` response property for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/portals/email-templates/variables/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)
