---
title: "Get an interview template"
method: GET
path: "/api/v2/interview-templates/{template_id}"
tags: ["Interview Templates"]
---

# Get an interview template

`GET /api/v2/interview-templates/{template_id}`

Returns a single interview template by ID.

## Path parameters

- `template_id` string, required

## Headers

- `X-API-KEY` string, nullable
- `Authorization` string, nullable
- `X-Workspace-Id` string, nullable

## Response `200`

Successful Response

- SingleResponseInterviewTemplateResponse
  - `data` InterviewTemplateResponse, required — A reusable interview agent configuration. Interview templates capture a blueprint posting's full agentic workflow (questions, criteria, agent settings) so it can be cloned onto new postings or used as the seed for new agents. Each template references its blueprint posting via ``posting_id``.
    - `object` 'interview_template' — Object type identifier.
    - `id` string, required — Unique interview template identifier.
    - `template_code` string, required — Human-readable template code used for ATS integrations. Alphanumeric and dashes only, max 32 characters, unique per workspace.
    - `name` string, required — Human-readable template name.
    - `description` string, nullable — Optional description of the template.
    - `posting_id` string, required — ID of the blueprint posting whose workflow, questions, and agent configuration this template captures.
    - `is_default` boolean — Whether this template is the workspace default.
    - `created_at` number, required — Unix timestamp when the template was created.
    - `updated_at` number, required — Unix timestamp when the template was last updated.
  - `meta` object, nullable — Optional metadata. Shape varies by endpoint.

## Other responses

- `401` — Invalid or missing API key.
- `404` — Interview template not found.
- `422` — Validation Error
- `429` — Rate limit exceeded.

---

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