Get service tickets filtered and paged

paging.pageSize

integer

No

Maximum number of tickets to return per page. Defaults to 100 when not given. Minimum 1, maximum 1000.

paging.pageNumber

integer

No

Page number to retrieve. Defaults to 1 when not given. Minimum 1, maximum 9999.

sorting.columnName

string

No

Field the results are sorted on, for example stateName.

sorting.order

integer

No

Sort direction for columnName. Valid values are 0 (Ascending) or 1 (Descending).

filter.reference

string

No

Filters results on the internal identifier of the ticket.

filter.externalIdentifier

string

No

Filters results on the external identifier of the ticket.

filter.reportingDate.from

string (date-time)

No

Earliest reportingDate to include in the selection. ISO 8601 format.

filter.reportingDate.to

string (date-time)

No

Latest reportingDate to include in the selection. ISO 8601 format.

filter.stateName

string

No

Filters results on the ticket's state name, for example Active.

filter.priority

integer

No

Filters results on priority. Valid values are 1 (Low), 2 (Normal), or 3 (High).

filter.problemCategoryName

string

No

Filters results on the problem category name.

filter.realEstateObjectReference

string

No

Filters results on the reference of the real estate object the ticket applies to.

filter.reporterReference

string

No

Filters results on the reference of the relation to contact regarding the ticket.

filter.tenantReference

string

No

Filters results on the tenant reference. This is automatically populated based on the tenant registered on the property at the time the ticket was submitted; it is not a field set directly when creating or updating a ticket.

filter.supplierReference

string

No

Filters results on the reference of the supplier handling the ticket.

paging.pageSize

integer

No

Page size used for this result set. Minimum 1, maximum 1000.

paging.pageNumber

integer

No

Page number returned in this result set. Minimum 1, maximum 9999.

sorting.columnName

string

No

Field the results are sorted on.

sorting.order

integer

No

Sort direction for columnName. 0 is Ascending, 1 is Descending.

serviceTickets

array of object

No

The list of tickets matching the filter, for the requested page. Empty or omitted when no tickets match.

serviceTickets.reference

string

No

Internal identifier of the ticket.

serviceTickets.externalIdentifier

string

No

External identifier of the ticket, as set by the integrating system.

serviceTickets.reportingDate

string (date-time)

Yes

Date and time the ticket was created.

serviceTickets.stateName

string

No

Name of the ticket's current state.

serviceTickets.priority

integer

Yes

Priority of the report. Valid values are 1 (Low), 2 (Normal), or 3 (High).

serviceTickets.problemCategoryName

string

No

Problem category the ticket belongs to.

serviceTickets.realEstateObjectReference

string

No

Reference of the real estate object the ticket applies to.

serviceTickets.reporterReference

string

No

Reference of the relation to contact regarding the ticket.

serviceTickets.tenantReference

string

No

Tenant reference, automatically populated based on the tenant registered on the property at the time the ticket was submitted.

serviceTickets.supplierReference

string

No

Reference of the supplier handling the ticket.