---
title: "Listing custom-fields of a job template"
method: GET
path: "/job-templates/{jobTemplateId}/custom-fields"
tags: ["Job Templates"]
---

# Listing custom-fields of a job template

`GET /job-templates/{jobTemplateId}/custom-fields`

## Request

- Base URL: `https://api.gupy.io/api/v1`
- URL: `https://api.gupy.io/api/v1/job-templates/{jobTemplateId}/custom-fields`
- Auth: HTTP bearer

Returns a list of custom fields of a job template.

## Path parameters

- `jobTemplateId` integer, required

## Response `200`

An array of job template custom fields

- JobTemplateCustomFields: An array of job template custom field
  - `results` JobCustomField[], required
    - `id` string: Custom field id
    - `label` string: Custom field label
    - `value` union: Custom field provided value
      - string
      - string[]
    - `type` 'select' | 'multiSelect' | 'text' | 'boolean' | 'number' | 'date' | 'time': Custom field type
    - `order` integer: Custom field order of appearance when editing a job
    - `required` boolean: Informs if this custom field response is mandatory
    - `enum` string[]: Possible options to be provided as value
  - `totalResults` integer
  - `page` integer
  - `totalPages` integer

## Other responses

- `400`: BadRequest / Invalid Input
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/gupy/apis/gupy-public-api.md) - [All operations](https://skmtc.dev/gupy/apis/gupy-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gupy/apis/gupy-public-api/revisions/b84c14658872?raw)