---
title: "Get a monitor user template"
method: GET
path: "/api/v2/monitor/template/{template_id}"
tags: ["Monitors"]
---

# Get a monitor user template

`GET /api/v2/monitor/template/{template_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/monitor/template/{template_id}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `monitors_read`

Retrieve a monitor user template by its ID.

## Path parameters

- `template_id` string, required

## Query parameters

- `with_all_versions` boolean

## Response `200`

OK

- MonitorUserTemplateResponse: Response for retrieving a monitor user template.
  - `data` MonitorUserTemplateResponseDataWithVersions: Monitor user template data.
    - `attributes` MonitorUserTemplate: A monitor user template object.
      - `created` string, date-time: The created timestamp of the template.
      - `description` string, nullable: A brief description of the monitor user template.
      - `modified` string, date-time: The last modified timestamp. When the template version was created.
      - `monitor_definition` object: A valid monitor definition in the same format as the [V1 Monitor API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor).
      - `tags` string[]: The definition of `MonitorUserTemplateTags` object.
      - `template_variables` MonitorUserTemplateTemplateVariablesItems[]: The definition of `MonitorUserTemplateTemplateVariables` object.
        - `available_values` string[]: Available values for the variable.
        - `defaults` string[]: Default values of the template variable.
        - `name` string, required: The name of the template variable.
        - `tag_key` string: The tag key associated with the variable. This works the same as dashboard template variables.
      - `title` string: The title of the monitor user template.
      - `version` integer, nullable: The version of the monitor user template.
      - `versions` SimpleMonitorUserTemplate[]: All versions of the monitor user template.
        - `created` string, date-time: The created timestamp of the template.
        - `description` string, nullable: A brief description of the monitor user template.
        - `id` string: The unique identifier. The initial version will match the template ID.
        - `monitor_definition` object: A valid monitor definition in the same format as the [V1 Monitor API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor).
        - `tags` string[]: The definition of `MonitorUserTemplateTags` object.
        - `template_variables` MonitorUserTemplateTemplateVariablesItems[]: The definition of `MonitorUserTemplateTemplateVariables` object.
          - `available_values` string[]: Available values for the variable.
          - `defaults` string[]: Default values of the template variable.
          - `name` string, required: The name of the template variable.
          - `tag_key` string: The tag key associated with the variable. This works the same as dashboard template variables.
        - `title` string: The title of the monitor user template.
        - `version` integer, nullable: The version of the monitor user template.
    - `id` string: The unique identifier.
    - `type` 'monitor-user-template': Monitor user template resource type.

## Other responses

- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)