Skip to main content

Get a Job

This service returns the details of a single job using either the Job Id or the Job Reference.

Query String Parameters

NameTypeDescriptionRequired
ActionStringJobRequired
JobIdIntThe unique identifier of the job, which can be retrieved using any of the methods listed under add something here.Required
JobRefStringThe reference of the job that is input as free text.Required
FlagHistoryBoolInclude the flags set against the job.Optional
IncludeCancelledBoolCheck for cancelled job with the supplied Id or Ref.Optional
IncludeAssistantsBoolInclude assistant detail for the job.Optional
JobPOStringTo search for a job using the PO number, use this parameter instead of JobId and JobRef. Must be used in conjunction with ContactId.Optional
ExcludeJobStatusIdsStringA list of Ids separated by comma. Used to exclude specific job statuses: Optional
ContactIdIntOptional parameter when supplying JobPO only.Optional
ContactParentIdIntOptional parameter when supplying JobPO only.Optional
IncludeWorksheetsBoolInclude detail of selected worksheets.Optional
IncludeWSABoolInclude actual worksheet answers where available.Optional
IncludeConstraintsBoolOptional
note

RealStart, RealEnd, RealDuration, PrIntName, CustNote and ResNote are only returned if the job has been completed.

tip
Either the Job Id or Reference can be supplied. If both parameters are provided, the Job Id will take precedence.

Response Codes

CodeMessageInformation
0No results
0GetJob(loggedUser
0jobresult
0jobList
2JobId
2Invalid or missing parameter - jobId
2Invalid ContactParentId parameter.
2Invalid ContactId parameter.

Example

Request URL

https://webservice.bigchange.com/v01/services.ashx?action=job