Read the authenticated organization profile and billing mode
LogsGET /organizations/{organizationID}
Returns the organization record, including its status and billing mode, to staff signed in to that organization. The caller must be acting in an organization context whose ID matches the path and must hold the organization:accounts:read scope; otherwise the call returns 403.
Parameters
organizationIDID of the organization; it must equal the organization the caller is currently acting in, or the request is refused.
Returns
200 Organization profile
Show attributes
idnametypeone of
utility,authority,operator,regulator,partner,groupstatusutility_kindone of
authority,municipal,regional,national,rural,private,industrialbilling_modeone of
account,organization
Errors 403
Permissions organization:accounts:read · Roles: account_admin, account_analyst, account_finance, account_owner, account_support
curl -X GET "$BUSINESS_API/organizations/{organizationID}" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/organizations/{organizationID}", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/organizations/{organizationID}",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/organizations/{organizationID}", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"id": "org_2ZNeUPlw01Za6RbKMZDGGbR4cV5",
"name": "Ana Matsinhe",
"type": "utility",
"status": "active",
"utility_kind": "authority",
"billing_mode": "account"
}