Schemes
Get Schemes
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
Schemes
Get Schemes
Returns all schemes
GET
/
v3
/
orgs
/
{orgId}
/
governance
/
schemes
curl --request GET \
--url https://api.ctrl-hub.com/v3/orgs/{orgId}/governance/schemes \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"type": "schemes",
"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",
"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"
}
}
],
"meta": {
"counts": {
"limit": 10
},
"page": {
"limit": 10,
"offset": {
"current": 20,
"next": 30,
"previous": 10
}
}
},
"links": {
"current": "https://api.ctrl-hub.com/v3/governance/schemes?limit=10&offset=20",
"next": "https://api.ctrl-hub.com/v3/governance/schemes?limit=10&offset=30",
"previous": "https://api.ctrl-hub.com/v3/governance/schemes?limit=10&offset=10"
}
}
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
Query Parameters
Limit the number of resources returned by the API
Offset for resources returned by the API
A field in the resource to sort results with. Not all attributes are supported, please see the Object Model for sortable fields.
Response
200
application/json
The resource type
Available options:
schemes
The ID of the schemes
The name of the scheme
The code of the scheme
The description of the scheme
The status of the scheme
Available options:
In Planning
, Live
, On Hold
, Complete
, Cancelled
The start date of the scheme
The end date of the scheme
curl --request GET \
--url https://api.ctrl-hub.com/v3/orgs/{orgId}/governance/schemes \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"type": "schemes",
"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",
"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"
}
}
],
"meta": {
"counts": {
"limit": 10
},
"page": {
"limit": 10,
"offset": {
"current": 20,
"next": 30,
"previous": 10
}
}
},
"links": {
"current": "https://api.ctrl-hub.com/v3/governance/schemes?limit=10&offset=20",
"next": "https://api.ctrl-hub.com/v3/governance/schemes?limit=10&offset=30",
"previous": "https://api.ctrl-hub.com/v3/governance/schemes?limit=10&offset=10"
}
}