---
title: "List service quotas"
method: GET
path: "/core/v1/service-quotas"
tags: ["Service Quotas"]
---

# List service quotas

`GET /core/v1/service-quotas`

Returns the latest service quota usage snapshots collected by DoiT for the authenticated customer.
Results include only quotas retained by DoiT's monitoring collectors and are not a complete or live inventory from the cloud providers.
Results are sorted by utilization percentage in descending order.

## Query parameters

- `provider` 'aws' | 'gcp'
- `minUtilizationPercent` number, double
- `maxResults` integer
- `pageToken` string

## Response `200`

OK - Service quotas returned.

- ServiceQuotaList
  - `items` ServiceQuota[], required — Service quotas in this page.
    - `provider` 'aws' | 'gcp', required — Cloud provider that owns the quota.
    - `resource` ServiceQuotaResource, required
      - `type` 'account' | 'project', required — Provider resource scope for the quota.
      - `id` string, required — AWS account ID or Google Cloud project ID.
      - `name` string — Human-readable resource name when available.
    - `service` string, required — Cloud service associated with the quota.
    - `quota` string, required — Provider quota or metric name.
    - `region` string — Cloud region associated with the quota. Omitted for global quotas.
    - `limit` number, double, required — Current quota limit.
    - `usage` number, double, required — Current measured quota usage.
    - `utilizationPercent` number, double, required — Usage divided by limit, expressed as a percentage.
    - `status` 'ok' | 'warning' | 'exceeded', required — Normalized utilization status. Warning begins at 80 percent; exceeded begins at 100 percent.
    - `observedAt` string, date-time, required — Time when DoiT last updated the provider snapshot.
  - `pageToken` string — Opaque token for the next page. Omitted when there are no more results.
  - `rowCount` integer, required — Total number of results after filtering and before pagination.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `500` — Internal Server Error - Something went wrong with the DoiT API server.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)