Get a job type
Retrieve the details of a single job type (required scope jobs:read)
Path Parameters
Possible values: >= 1
The unique identifer of the job type
Header Parameters
The customer identifier
- 200
- 400
- 403
- 404
- 500
Success
Schema
The unique identifier of the job type
The name of the job type
The default textual description for jobs of this type
The default planned duration for jobs of this type, specified in minutes
The unique identifier of default category for jobs of this type
A flag determining if a type is archived - new jobs cannot be created against archived job types
A flag determining if an order number is required for jobs of this type
The result options for when a job is completed successfully
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
{
"id": 5514123,
"name": "Combi boiler installation",
"description": "New boiler install - please remove and retain the old boiler",
"plannedDuration": 90,
"categoryId": 5514123,
"isArchived": false,
"isOrderNumberRequired": true,
"positiveResults": [
"string"
],
"negativeResults": [
"string"
]
}
Bad Request
Schema
A URI reference [RFC3986] that identifies the problem type
A short, human-readable summary of the problem type
The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem
A human-readable explanation specific to this occurrence of the problem
A URI reference that identifies the specific occurrence of the problem
{
"type": "https://example.com/probs/out-of-credit",
"title": "You do not have enough credit",
"status": 403,
"detail": "Your current balance is 30, but that costs 50",
"instance": "/account/12345/msgs/abc"
}
Forbidden
Schema
A URI reference [RFC3986] that identifies the problem type
A short, human-readable summary of the problem type
The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem
A human-readable explanation specific to this occurrence of the problem
A URI reference that identifies the specific occurrence of the problem
{
"type": "https://example.com/probs/out-of-credit",
"title": "You do not have enough credit",
"status": 403,
"detail": "Your current balance is 30, but that costs 50",
"instance": "/account/12345/msgs/abc"
}
Not Found
Schema
A URI reference [RFC3986] that identifies the problem type
A short, human-readable summary of the problem type
The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem
A human-readable explanation specific to this occurrence of the problem
A URI reference that identifies the specific occurrence of the problem
{
"type": "https://example.com/probs/out-of-credit",
"title": "You do not have enough credit",
"status": 403,
"detail": "Your current balance is 30, but that costs 50",
"instance": "/account/12345/msgs/abc"
}
Server Error
Schema
A URI reference [RFC3986] that identifies the problem type
A short, human-readable summary of the problem type
The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem
A human-readable explanation specific to this occurrence of the problem
A URI reference that identifies the specific occurrence of the problem
{
"type": "https://example.com/probs/out-of-credit",
"title": "You do not have enough credit",
"status": 403,
"detail": "Your current balance is 30, but that costs 50",
"instance": "/account/12345/msgs/abc"
}