---
title: "Retrieve template by ID"
method: GET
path: "/fleetify/document_templates/{id}"
tags: ["Dispatches_Documents"]
---

# Retrieve template by ID

`GET /fleetify/document_templates/{id}`

## Query parameters

- `key` string, required

## Response `200`

- object
  - `status` integer — Returns the HTTP response code.
  - `msg` string — Returns the error message in case of a failed request. If the request is successful, this field is not present in the response.
  - `data` object — An object returning the details of the requested document template.
    - `id` string — Returns the unique identifier of the document template.
    - `name` string — Returns the name of the document template as specified at the time of creating the template.
    - `content` DocumentTemplateContentResponse[] — An array of objects returning the details of data structures and validation rules and other properties of all document fields. Each object represents one document field.
      - `label` string — Returns the label of the document field.
      - `name` string — Returns the name of the document field.
      - `type` string — Returns the data type of the document field. It will always belong to one of string, number, date_time, photos, multi_choices, signature, barcode, and single_choice.
      - `required` boolean — Indicates if the document field is mandatory or not.
      - `validation` object — Returns the validation rules for number , multi_choices , and photos document field types.
        - `min` integer — Returns the minimum allowed value for number type document item, as specified at the time of configuring the field. This parameter is not present in the response if it was not provided in the input.
        - `max` integer — Returns the maximum allowed value for number type document item, as specified at the time of configuring the field. This parameter is not present in the response if it was not provided in the input.
        - `min_items` string — Returns the minimum number of items required for multi_choices, photos type document items. This parameter will not be present in the response if it was not provided in the input.
        - `max_items` string — Returns the maximum number of items required for multi_choices, photos type document items. This parameter will not be present in the response if it was not provided in the input.
      - `meta` object — Returns the options configured for single_choice or multi_choices type document items.
        - `options` object[] — An array of objects returning the options for multi_choices or single_choice type document field. Each object represents one configured option.
          - `label` string — Returns the label for the option.
          - `value` string — Returns the value associated with the option. This value gets submitted when the option is checked in the Driver app.

---

[API](https://skmtc.net/nextbillion-ai/apis/one-spec-service.md) · [All operations](https://skmtc.net/nextbillion-ai/apis/one-spec-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextbillion-ai/one-spec-service/versions/b647f1808dda/schema)
