Get all service ticket costs categories
  • 09 May 2025
  • 1 Minute to read
  • Dark
    Light

Get all service ticket costs categories

  • Dark
    Light

Article summary

Get
/api/v1/maintenance/servicetickets/costscategories

[PREVIEW] Get all service ticket costs categories in the system.

Description

Service tickets have to be assigned to cost categories. However, in order to add the correct cost category the Bloxs user needs to know which cost categories are available in the application. This endpoint can be used to retrieve the available cost categories. This is a standard list.

The response provides the full list of available cost categories as an array.

Use Case

The PUT/servicetickets operation is used to update a service ticket. As part of this update, the user may want to specify the cost category associated with the service ticket. However, the user may not know which cost categories are available. This endpoint can be used to retrieve the full list of available cost categories.

Response fields

The 200 response contains the field in the table below. For every cost category this property will be shown separately in the array.

FieldDescription
nameThe name of the cost category.
The cost category indicates the type of problem reported and serves as a tool to determine how the related costs should be allocated. For example, if the central heating system is not producing heat, the issue may require either a repair or a full replacement—each falling under a different cost category.
Security
HTTP
Type Bearer

Please enter a valid token

Responses
200

OK

Array of object
object
name
string | null
systemState
integer (int32)

1 = Active

2 = OnHold

3 = SignedOff

4 = Done

Valid values[ \1\, \2\, \3\, \4\ ]