---
title: "Listing e-mail templates"
method: GET
path: "/email-templates"
tags: ["E-mail templates"]
---

# Listing e-mail templates

`GET /email-templates`

Returns a list of e-mail templates.

## Query parameters

- `fields` string
- `type` string
- `name` string
- `perPage` integer
- `page` integer

## Response `200`

An array of e-mail templates

- PaginatedEmailTemplate — An array of e-mail templates
  - `results` EmailTemplate[], required
    - `id` string, required — E-mail Template ID
    - `name` string, required — Name
    - `subject` string, required — Subject
    - `body` string, required — E-mail body
    - `type` 'interview_scheduling' | 'canceled_role' | 'invite_to_other_job' | 'process_engagement' | 'hiring_feedback' | 'negative_feedback' | 'test_or_challenge' | 'internal_recruitment_survey', required — Template type
  - `totalResults` integer
  - `page` integer
  - `totalPages` integer

## Other responses

- `400` — BadRequest / Invalid Input
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/gupy/apis/gupy-public-api.md) · [All operations](https://skmtc.net/gupy/apis/gupy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupy/gupy-public-api/revisions/3f26defa2a42/schema)