---
title: "List email templates"
method: GET
path: "/email-templates"
tags: ["Email Templates"]
---

# List email templates

`GET /email-templates`

## Request

- Base URL: `https://api.100hires.com/v2`
- URL: `https://api.100hires.com/v2/email-templates`
- Auth: HTTP bearer

Returns paginated email templates for the target company.

## Query parameters

- `company_id` integer
- `page` integer
- `size` integer
- `view` 'full' | 'summary'

## Response `200`

Email template list

- EmailTemplateListResponse
  - `email_templates` EmailTemplate[], required: Array of email templates.
    - `id` integer: Email template ID
    - `name` string: Template name
    - `subject` string: Email subject line as stored. Placeholders, when present, are stored as `<tag>` HTML produced by `POST /template-placeholders/prepare`; they are rendered to real values only at send time, not on read.
    - `body` string: Email body HTML as stored. Placeholders are stored as `<tag>` HTML produced by `POST /template-placeholders/prepare` and rendered at send time. Present only when `view=full` (default); omitted entirely when `view=summary` — template bodies can be tens of KB each.
    - `url_backoffice` string, uri: Absolute backoffice URL to edit this email template in the 100Hires recruiter app. Use to render deep-links in agent UIs.
    - `created_at` integer: Unix timestamp
    - `updated_at` integer: Unix timestamp
  - `pagination` Pagination, required
    - `page_size` integer, required: Items per page.
    - `page_count` integer, required: Total number of pages.
    - `page` integer, required: Current page number.
    - `total_count` integer, required: Total number of items.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests

---

[API](https://skmtc.dev/100hires/apis/100hires-api.md) · [All operations](https://skmtc.dev/100hires/apis/100hires-api/llms.txt) · [OpenAPI document](https://skmtc.dev/100hires/apis/100hires-api/revisions/e63e2d3115f7?raw)