Sign in
latestOpenAPI 3.0.12026-08-192092911.2 MB

916e669fc527

JobTypes

Get a list of job types

Retrieve a paged collection of job types (required scope jobs:read)

get/v1/jobTypes

Query parameters

sortBy'name'

Represents the fields that can be used to sort job types<p>Possible values:</p><ul><li><b>name</b>: The name of the job type</li></ul>

Example:name

The field to sort items in the page by

direction'ascending' | 'descending'

Represents the direction in which sorting should be applied<p>Possible values:</p><ul><li><b>ascending</b>: Indicates ascending sorting order</li><li><b>descending</b>: Indicates descending sorting order</li></ul>

Example:ascending

The direction to apply the sort

idinteger[]

Only return job types where id matches the value(s) provided (Max items: 50)

isTasksEnabledboolean

Only return job types where the 'isTaskEnabled' matches the provided value

pageNumberinteger

The page number being requested (minimum: 1, maximum: 2147483)

pageSizeinteger

The page size being requested (minimum: 1, maximum: 1000)

Headers

Customer-Idinteger required

The customer identifier

Response

OK

pageNumberinteger

The page number of the response where 1 is the first page

pageSizeinteger

The number of items requested for the current page

pageItemCountinteger

The number of items returned in the current page

Example response

{
  "items": [
    {
      "id": 5514123,
      "name": "Combi boiler installation",
      "description": "New boiler install - please remove and retain the old boiler",
      "plannedDuration": 90,
      "categoryId": 5514123,
      "isOrderNumberRequired": true,
      "isTasksEnabled": true,
      "customFieldDefinitions": [
        {
          "id": 12345,
          "caption": "Favourite colour",
          "type": "boolean",
          "listOptions": [
            "Red",
            "Blue",
            "Green",
            "Purple"
          ],
          "isRequired": true,
          "isEditable": true,
          "default": "10"
        }
      ]
    }
  ],
  "pageNumber": 2,
  "pageSize": 100,
  "pageItemCount": 55
}