Sign in
latestOpenAPI 3.0.12026-08-192092911.2 MB

916e669fc527

JobTypes

Get a job type

Retrieve the details of a single job type (required scope jobs:read)

get/v1/jobTypes/{jobTypeId}

Path parameters

jobTypeIdinteger required

The unique identifer of the job type

Headers

Customer-Idinteger required

The customer identifier

Response

OK

idinteger

The unique identifier of the job type

namestring

The name of the job type

descriptionstring

The default textual description for jobs of this type

plannedDurationinteger

The default planned duration for jobs of this type, specified in minutes

categoryIdinteger nullable

The unique identifier of default category for jobs of this type

isArchivedboolean

A flag determining if a type is archived - new jobs cannot be created against archived job types

isOrderNumberRequiredboolean

A flag determining if an order number is required for jobs of this type

isTasksEnabledboolean

A flag determining if tasks are used for this job type

positiveResultsstring[] nullable

The result options for when a job is completed successfully

negativeResultsstring[] nullable

The result options for when a job is completed with issues. If null then jobs of this type will not be allowed to have the status of completedWithIssues

Example response

{
  "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"
    }
  ]
}