# 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

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |

## Responses

### 200 — Success

Content-Type: `application/json` · Schema: `GetOrganizationLicensesAndServicesResponse`

**`GetOrganizationLicensesAndServicesResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `licenses` | array<LicenseView> | no |  |
| `organization_id` | string | no |  |
| `services` | array<OrganizationServiceView> | no |  |
| `suger_contacts` | SugerContacts | no |  |

**`LicenseView`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `end_date` | string | no |  |
| `id` | string | no |  |
| `license_type` | string | no |  |
| `start_date` | string | no |  |

**`OrganizationServiceView`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `available` | boolean | no |  |
| `display_name` | string | no |  |
| `enabled` | boolean | no |  |
| `id` | ServiceID | no |  |
| `over_quota` | integer | no |  |
| `quota` | integer | no |  |
| `quota_bearing` | boolean | no |  |
| `quota_unit` | QuotaUnit | no |  |
| `quotas` | array<ProfessionalServicesQuotaPeriodView> | no |  |
| `remaining` | integer | no |  |
| `usage_mtd` | integer | no |  |

**`SugerContacts`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `account_executive` | SugerContact | no |  |
| `customer_success` | SugerContact | no |  |
| `product_solution` | SugerContact | no |  |

**`ProfessionalServicesQuotaPeriodView`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `created_by_display_name` | string | no |  |
| `created_by_user_id` | string | no |  |
| `creation_time` | string | no |  |
| `end_date` | string | no |  |
| `id` | string | no |  |
| `last_update_time` | string | no |  |
| `last_updated_by_display_name` | string | no |  |
| `last_updated_by_user_id` | string | no |  |
| `quota_minutes` | integer | no |  |
| `start_date` | string | no |  |

**`SugerContact`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `email` | string | no |  |
| `name` | string | no |  |

### 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](https://doc.fours.com/settings/oauth-app/)._

### Request

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

### Response — 200

```json
{
  "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

```json
"string"
```

---

API reference: https://doc.fours.com/api/