API Documentation
Governance
- Organisations
- Schemes
- Work Orders
- Permits
- Operations
- Properties
- Streets
Data Capture
- Forms
- Form Categories
- Submissions
- Submission Versions
Operations
- Reinstatements
Assets
- Vehicles
Admin
- IAM
Get Operations
Returns a work orders operations
curl --request GET \
--url https://api.ctrl-hub.com/v3/orgs/{orgId}/governance/schemes/{schemeId}/work-orders/{workOrderId}/operations \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"type": "operations",
"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/operations/5852cf16-8ec8-4aba-809e-f8d828772c4e"
}
}
]
}
Sort Support
Resources can be sorted by name
, code
, status
or created_at
Authorizations
To understand how to authenticate, see the auth docs
Path Parameters
The ID of the organisation
"cc9746e0-9286-4575-ae0b-ac1b0fe873a6"
The ID of the scheme
"5852cf16-8ec8-4aba-809e-f8d828772c4e"
The ID of the work order
"5852cf16-8ec8-4aba-809e-f8d828772c4e"
Response
The resource type
operations
"operations"
The ID of the operation
"5852cf16-8ec8-4aba-809e-f8d828772c4e"
The name of the operation
"IMGA100000"
The code of the operation
"CODE001"
The description of the operation
"DESC-123456"
The status of the scheme
In Planning
, Live
, On Hold
, Complete
, Cancelled
"active"
The start date of the operation
"2024-06-13T00:00:00.000Z"
The end date of the operation
"2024-08-13T00:00:00.000Z"
An array of UPRN's (Unique Property Reference Number) related to the work order
[10022999531]
An array of USRN's (Unique Street Reference Number) related to the work order
[14924880]
curl --request GET \
--url https://api.ctrl-hub.com/v3/orgs/{orgId}/governance/schemes/{schemeId}/work-orders/{workOrderId}/operations \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"type": "operations",
"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/operations/5852cf16-8ec8-4aba-809e-f8d828772c4e"
}
}
]
}