Get the current organization's services and quotas

GET https://api.suger.cloud/org/{orgId}/services-and-quotas

Customer-facing read endpoint returning the requesting organization's services snapshot — every catalog service with availability, enablement, the current-period quota usage, remaining/overage minutes, and the full Professional Services quota-period list. Access is gated by org-membership auth: the caller must be a member of {orgId}, and the endpoint returns data only for the caller's own organization.

Parameters

Responses

200 — Success

Content-Type: application/json · Schema: GetOrganizationLicensesAndServicesResponse

GetOrganizationLicensesAndServicesResponse fields:

LicenseView fields:

OrganizationServiceView fields:

SugerContacts fields:

ProfessionalServicesQuotaPeriodView fields:

SugerContact fields:

500 — Internal server error

Content-Type: application/json

Example

Generated from this operation's schema. Values are placeholders — substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X GET 'https://api.suger.cloud/org/{orgId}/services-and-quotas' \
  -H "Authorization: Bearer $SUGER_TOKEN"

Response — 200

{
  "licenses": [
    {
      "end_date": "2026-01-31T12:00:00Z",
      "id": "01H0000000000000000000",
      "license_type": "string",
      "start_date": "2026-01-31T12:00:00Z"
    }
  ],
  "organization_id": "01H0000000000000000000",
  "services": [
    {
      "available": true,
      "display_name": "Acme Corp",
      "enabled": true,
      "id": "AI_USAGE",
      "over_quota": 1,
      "quota": 1,
      "quota_bearing": true,
      "quota_unit": "",
      "quotas": [
        {
          "created_by_display_name": "Acme Corp",
          "created_by_user_id": "01H0000000000000000000",
          "creation_time": "2026-01-31T12:00:00Z",
          "end_date": "2026-01-31T12:00:00Z",
          "id": "01H0000000000000000000",
          "last_update_time": "2026-01-31T12:00:00Z",
          "last_updated_by_display_name": "2026-01-31T12:00:00Z",
          "last_updated_by_user_id": "01H0000000000000000000",
          "quota_minutes": 1,
          "start_date": "2026-01-31T12:00:00Z"
        }
      ],
      "remaining": 1,
      "usage_mtd": 1
    }
  ],
  "suger_contacts": {
    "account_executive": {
      "email": "buyer@example.com",
      "name": "Acme Corp"
    },
    "customer_success": {
      "email": "buyer@example.com",
      "name": "Acme Corp"
    },
    "product_solution": {
      "email": "buyer@example.com",
      "name": "Acme Corp"
    }
  }
}

Error — 500

"string"

View as Markdown · Interactive API reference