Skip to main content

Get a Paged List of Jobs by Contact

Allows you to retrieve large numbers of job records, specifying the number of records returned in each page.

Query String Parameters

NameTypeDescriptionRequired
ActionStringJobsListByContactPagedRequired
ContactIdIntRequired
ContactRefStringUse when ContactId is not supplied.Required
StartDateDate to retrieve jobs from. Format: yyyy-MM-dd HH:mm:ss.Required
EndDateDate to retrieve jobs data to. Format: yyyy-MM-dd HH:mm:ss.Required
JobStatusStringSelect one from: New, Scheduled, Unscheduled, Sent, Refused, OnTheWay, Started, Suspended, CompletedOk, CompletedNOK.Required
PageIntStarts at 0.Required
PageSizeIntMinimum 1, maximum 5000.Required
CheckContactDescendantsBoolWhen true, the descendants of the supplied contact will be used to retrieve the jobs list. 1 = true, default is 0.Optional

Response Codes

CodeMessageInformation
2 error - jobViewAllocated
2 error - obViewUnallocated
2 error - pagesize
0No results
0returnedjobs
2contactRef or contactId parameter required
2page parameter required
2pagesize parameter required
2jobStatus parameter not a valid value: + queryString[jobStatus]

Example

Request URL

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