API ReferenceJobs

Get Job

Returns a single job by ID.

Requires scope: jobs:read

Authentication

API_KEYstring
API Key authentication via header

Path parameters

idUUIDRequired
Job ID.

Response

This endpoint returns an object.
idUUID
Unique identifier for the job.
namestring
Display name of the job.
createdAtdatetime
ISO 8601 timestamp when the record was created.
updatedAtdatetime
ISO 8601 timestamp when the record was last updated.
numberstring
Job number or external reference.
clientobject
Client contact associated with the job.
scheduledAtdatetime
ISO 8601 timestamp for when the job is scheduled.
notestring

Free-form notes attached to the job.

addressobject
Address where the job is performed.
activeboolean

Whether the job is currently active. Archived jobs are returned with false.

assignedUserIdslist of UUIDs

IDs of users (technicians) assigned to this job.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error