Service Accounts
Get Service Accounts
API Documentation
Governance
- Organisations
- Schemes
- Work Orders
- Permits
- Operations
- Properties
- Streets
Data Capture
- Forms
- Form Categories
- Submissions
- Submission Versions
Operations
- Reinstatements
Assets
- Vehicles
Admin
Service Accounts
Get Service Accounts
Returns all service accounts for an organisation
GET
/
v3
/
orgs
/
{orgId}
/
iam
/
service-accounts
curl --request GET \
--url https://api.ctrl-hub.com/v3/orgs/{orgId}/iam/service-accounts \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"type": "service-accounts",
"id": "14b28316-9c20-8a7d-e85a-b62f29a29ac5",
"attributes": {
"name": "ACME Corp",
"description": "This service account is for integrating with ACME Corp",
"enabled": true,
"email": "acmecorp@7e0c875a-fd47-401d-bd25-4278ed58d721.iam.ctrl-hub.com"
},
"meta": {
"created_at": "2024-10-14T17:03:06.204Z"
},
"relationships": {
"keys": {
"data": [
{
"type": "service-account-keys",
"id": "4c9d6aa9-f658-4e9e-8510-39d05a574018"
}
]
}
}
}
],
"meta": {
"counts": {
"limit": 10
},
"page": {
"limit": 10,
"offset": {
"current": 20,
"next": 30,
"previous": 10
}
}
},
"links": {
"current": "https://api.ctrl-hub.com/v3/orgs/7e0c875a-fd47-401d-bd25-4278ed58d721/iam/service-accounts?limit=10&offset=20",
"next": "https://api.ctrl-hub.com/v3/orgs/7e0c875a-fd47-401d-bd25-4278ed58d721/iam/service-accounts?limit=10&offset=30",
"previous": "https://api.ctrl-hub.com/v3/orgs/7e0c875a-fd47-401d-bd25-4278ed58d721/iam/service-accounts?limit=10&offset=10"
}
}
Authorizations
To understand how to authenticate, see the auth docs
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
Available options:
service-accounts
The role name
A description for the service account
Whether the service account is enabled or not
A system generated email address for the service account, comprising of the service account ID and the IAM domain
curl --request GET \
--url https://api.ctrl-hub.com/v3/orgs/{orgId}/iam/service-accounts \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"type": "service-accounts",
"id": "14b28316-9c20-8a7d-e85a-b62f29a29ac5",
"attributes": {
"name": "ACME Corp",
"description": "This service account is for integrating with ACME Corp",
"enabled": true,
"email": "acmecorp@7e0c875a-fd47-401d-bd25-4278ed58d721.iam.ctrl-hub.com"
},
"meta": {
"created_at": "2024-10-14T17:03:06.204Z"
},
"relationships": {
"keys": {
"data": [
{
"type": "service-account-keys",
"id": "4c9d6aa9-f658-4e9e-8510-39d05a574018"
}
]
}
}
}
],
"meta": {
"counts": {
"limit": 10
},
"page": {
"limit": 10,
"offset": {
"current": 20,
"next": 30,
"previous": 10
}
}
},
"links": {
"current": "https://api.ctrl-hub.com/v3/orgs/7e0c875a-fd47-401d-bd25-4278ed58d721/iam/service-accounts?limit=10&offset=20",
"next": "https://api.ctrl-hub.com/v3/orgs/7e0c875a-fd47-401d-bd25-4278ed58d721/iam/service-accounts?limit=10&offset=30",
"previous": "https://api.ctrl-hub.com/v3/orgs/7e0c875a-fd47-401d-bd25-4278ed58d721/iam/service-accounts?limit=10&offset=10"
}
}