---
title: "Get interview template by id."
method: GET
path: "/templates/{id}"
tags: ["interview-templates"]
---

# Get interview template by id.

`GET /templates/{id}`

## Request

- Base URL: `https://api.smartrecruiters.com/interview-templates`
- URL: `https://api.smartrecruiters.com/interview-templates/templates/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Client credentials
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `interview_templates_manage`
  - API key in header `x-smarttoken`

Returns a interview template by id.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successfully found interview template.

- InterviewTemplateDetails
  - `templateId` string, uuid: Template id
  - `templateName` string: Template name
  - `templateType` 'INDIVIDUAL' | 'GROUP': Template type
  - `hiringStage` string: Preferred hiring stage to which the template applies
  - `hiringStep` string: Preferred hiring step to which the template applies
  - `customHiringStep` boolean: Custom Hiring step
  - `privateInterview` boolean: Flag indicating whether the interview invitation is private
  - `hiringTeamRoleToInterviewerCount` object: Required number of interviewers for given hiring team roles
  - `invitations` InvitationExternal[]: List containing interview invitations
    - `email` EmailInvitationExternal: Email invitation
      - `subject` string: Email subject
      - `content` string: Email content
      - `bccEmployeeIds` string[]: List of employees who will receive a copy of this invitation
    - `sms` SmsInvitationExternal: Sms invitation
      - `content` string: Invitation content
      - `confirmationMessage` string: Confirmation message
    - `whatsApp` WhatsAppInvitationExternal: WhatsApp invitation
      - `enabled` boolean: WhatsApp invitation enabled?
    - `line` LineInvitationExternal: Line invitation
      - `content` string: Invitation content
      - `confirmationMessage` string: Confirmation message
    - `language` string: The language the invitation will be translated into
    - `repeat` RepeatExternalDto: Repeat invitation configuration
      - `intervalInMinutes` integer: Time between invitations resends in minutes. Maximum value is 4320 minutes (3 days).
      - `count` integer: Number of times that invitation will be sent again. Maximum value is 5.
  - `reminders` ReminderExternal[]: List containing interview reminders
    - `reminderChannel` 'SMS' | 'WHATS_APP' | 'LINE_ME' | 'EMAIL': Communication method for the reminder to be sent.
    - `advanceTimes` integer[]: List of delivery times indicating how many times and how many minutes before the interview the reminder should be sent.
    - `message` ReminderMessageExternal: Content of the reminder message. Applies only to Sms, Line and Email reminders. WhatsApp reminders uses predefined templates which are resolved just before sending them to candidates.
      - `subject` string: Subject of the reminder. Applies only to email reminders.
      - `content` string: Content of the reminder.
      - `bccEmployeeIds` string[]: List of employees who will receive a copy of this reminder
    - `language` string: Language in which the reminder message has been written.
  - `slotSetup` SlotSetupExternal: Slot setup view
    - `ignoreInterviewersAvailability` boolean, required: Ignore Interviewers Availability
    - `varied` object: Varied time slots setup
    - `uniform` SlotItemUniformSetupExternal: Uniform slot setup
      - `durationInMinutes` integer: Duration of the interview
      - `format` 'ONSITE_JOB' | 'ONSITE' | 'PHONE' | 'VIDEO' | 'VIDEO_CALENDAR' | 'VIDEO_MEETING_ZOOM' | 'OTHER': Format of the interview
      - `location` string: Location of the interview
      - `zoomHostId` string: Identifier of the user being the zoom interview host
      - `organizerId` string: Identifier of the user being the zoom interview organizer
  - `isDefault` boolean: Flag indicating whether the template is one of the predefined ones

## Other responses

- `400`: Invalid id.
- `401`: Unauthorized.
- `403`: Forbidden.

---

[API](https://skmtc.dev/smartrecruiters/apis/interview-templates-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/interview-templates-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/interview-templates-api/revisions/080537e890a2?raw)