Get a Work Order

cURL

curl --request GET \
  --url https://api.ctrl-hub.com/v3/orgs/{orgId}/governance/schemes/{schemeId}/work-orders/{workOrderId} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "type": "work-orders",
    "id": "5852cf16-8ec8-4aba-809e-f8d828772c4e",
    "attributes": {
      "name": "IMGA100000",
      "code": "CODE001",
      "description": "DESC-123456",
      "status": "active",
      "start_date": "2024-06-13T00:00:00.000Z",
      "end_date": "2024-08-13T00:00:00.000Z",
      "uprns": [
        10022999531
      ],
      "usrns": [
        14924880
      ],
      "labels": [
        {
          "key": "your-label",
          "value": "abc123"
        },
        {
          "key": "another-label",
          "value": "meaningful-value"
        }
      ]
    },
    "meta": {
      "created_at": "2024-06-13T07:15:23.000Z"
    },
    "links": {
      "self": "https://api.ctrl-hub.com/v3/governance/schemes/5852cf16-8ec8-4aba-809e-f8d828772c4e/work-orders/5852cf16-8ec8-4aba-809e-f8d828772c4e"
    }
  }
}

GET

orgs

{orgId}

governance

schemes

{schemeId}

work-orders

{workOrderId}

cURL

curl --request GET \
  --url https://api.ctrl-hub.com/v3/orgs/{orgId}/governance/schemes/{schemeId}/work-orders/{workOrderId} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "type": "work-orders",
    "id": "5852cf16-8ec8-4aba-809e-f8d828772c4e",
    "attributes": {
      "name": "IMGA100000",
      "code": "CODE001",
      "description": "DESC-123456",
      "status": "active",
      "start_date": "2024-06-13T00:00:00.000Z",
      "end_date": "2024-08-13T00:00:00.000Z",
      "uprns": [
        10022999531
      ],
      "usrns": [
        14924880
      ],
      "labels": [
        {
          "key": "your-label",
          "value": "abc123"
        },
        {
          "key": "another-label",
          "value": "meaningful-value"
        }
      ]
    },
    "meta": {
      "created_at": "2024-06-13T07:15:23.000Z"
    },
    "links": {
      "self": "https://api.ctrl-hub.com/v3/governance/schemes/5852cf16-8ec8-4aba-809e-f8d828772c4e/work-orders/5852cf16-8ec8-4aba-809e-f8d828772c4e"
    }
  }
}

Authorizations

Authorization

string

header

required

To understand how to authenticate, see the auth docs

Path Parameters

orgId

string

required

The ID of the organisation

Example:

"cc9746e0-9286-4575-ae0b-ac1b0fe873a6"

schemeId

string

required

The ID of the scheme

Example:

"5852cf16-8ec8-4aba-809e-f8d828772c4e"

workOrderId

string

required

The ID of the work order

Example:

"5852cf16-8ec8-4aba-809e-f8d828772c4e"

Response

data

object

Show child attributes

data.type

enum<string>

The resource type

Available options:

work-orders

Example:

"work-orders"

data.id

string<uuid>

The ID of the work orders

Example:

"5852cf16-8ec8-4aba-809e-f8d828772c4e"

data.attributes

object

Show child attributes

data.attributes.name

string

The name of the work orders

Example:

"IMGA100000"

data.attributes.code

string

The code of the work orders

Example:

"CODE001"

data.attributes.description

string

The description of the work orders

Example:

"DESC-123456"

data.attributes.status

enum<string>

The status of the scheme

Available options:

In Planning,

Live,

On Hold,

Complete,

Cancelled

Example:

"active"

data.attributes.start_date

string

The start date of the work orders

Example:

"2024-06-13T00:00:00.000Z"

data.attributes.end_date

string

The end date of the work orders

Example:

"2024-08-13T00:00:00.000Z"

data.attributes.uprns

number[]

An array of UPRN's (Unique Property Reference Number) related to the work order

Example:

[10022999531]

data.attributes.usrns

number[]

An array of USRN's (Unique Street Reference Number) related to the work order

Example:

[14924880]

data.attributes.labels

object[]

An array of label objects related to the scheme

Show child attributes

data.attributes.labels.key

string

data.attributes.labels.value

string

Example:

[
  { "key": "your-label", "value": "abc123" },
  {
    "key": "another-label",
    "value": "meaningful-value"
  }
]

data.meta

object

Show child attributes

data.meta.created_at

string

Sortable. The time the work order was created (RFC 3339)

Example:

"2024-06-13T07:15:23.000Z"

data.links

object

Show child attributes

data.links.self

string

Example:

"https://api.ctrl-hub.com/v3/governance/schemes/5852cf16-8ec8-4aba-809e-f8d828772c4e/work-orders/5852cf16-8ec8-4aba-809e-f8d828772c4e"

Get Work Orders Permit Model

⌘I

API Documentation

Governance

Data Capture

Operations

Assets

Admin

Authorizations

Path Parameters

Response