List utility integrations
LogsGET /integrations
List external integrations configured for this utility tenant
Returns the integrations registered for the tenant, newest first, with category, provider key, secret configuration reference (never the secret itself), status and last reported health. Results are cursor-paginated (default 20, maximum 100) and the q parameter matches the name case-insensitively; a negative limit returns 400. Requires the business:integrations:read permission.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
qResource-specific text search.
categoryReturn only integrations of this category: payment, identity, notification, smart_meter, gis, scada, document_store, accounting or erp.
one of
payment,identity,notification,smart_meter,gis,scada,document_store,accounting,erpstatusReturn only integrations in this status: active, suspended or disabled.
one of
active,suspended,disabledhealthReturn only integrations whose last reported health is unknown, healthy, degraded or unavailable.
one of
unknown,healthy,degraded,unavailable
Returns
200 Tenant-scoped integration registrations
Show attributes
dataShow child attributes
idtenant_idnamecategoryone of
payment,identity,notification,smart_meter,gis,scada,document_store,accounting,erpprovider_keyconfiguration_referenceOpaque secret/configuration reference; never a secret value.
statusone of
active,suspended,disabledhealthone of
unknown,healthy,degraded,unavailablelast_health_check_at
has_morenext_cursor
Permissions business:integrations:read · Roles: admin, operations, owner
curl -X GET "$BUSINESS_API/integrations" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/integrations", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/integrations",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/integrations", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "int_2s0jH8wLbKi9jSO5lWaRJWCPxso",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"name": "Ana Matsinhe",
"category": "payment",
"provider_key": "provider key",
"configuration_reference": "CON-2026-000142",
"status": "active",
"health": "unknown",
"last_health_check_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}