---
title: "Get all subscription throttling policies"
method: GET
path: "/subscription-policies"
tags: ["Subscription Validation"]
---

# Get all subscription throttling policies

`GET /subscription-policies`

This will provide access to subscription level throttling policies in database.

## Query parameters

- `policyName` string

## Headers

- `xWSO2Tenant` string, required

## Response `200`

An array of subscription policies in the database

- SubscriptionPolicyList
  - `count` integer — Number of SubscriptionPolices returned.
  - `list` SubscriptionPolicy[]
    - `id` integer
    - `tenantId` integer
    - `tenantDomain` string
    - `name` string
    - `quotaType` string
    - `graphQLMaxComplexity` integer — Maximum Complexity of the GraphQL query
    - `graphQLMaxDepth` integer — Maximum Depth of the GraphQL query
    - `rateLimitCount` integer
    - `rateLimitTimeUnit` string
    - `stopOnQuotaReach` boolean
    - `defaultLimit` ThrottleLimit
      - `quotaType` string
      - `requestCount` RequestCountLimit
        - `timeUnit` string, required — Unit of the time. Allowed values are "sec", "min", "hour", "day"
        - `unitTime` integer, required — Time limit that the throttling limit applies.
        - `requestCount` integer, required — Maximum number of requests allowed
      - `bandwidth` BandwidthLimit
        - `timeUnit` string, required — Unit of the time. Allowed values are "sec", "min", "hour", "day"
        - `unitTime` integer, required — Time limit that the throttling limit applies.
        - `dataAmount` integer, required — Amount of data allowed to be transfered
        - `dataUnit` string, required — Unit of data allowed to be transfered. Allowed values are "KB", "MB" and "GB"
      - `eventCount` EventCountLimit
        - `timeUnit` string, required — Unit of the time. Allowed values are "sec", "min", "hour", "day"
        - `unitTime` integer, required — Time limit that the throttling limit applies.
        - `eventCount` integer, required — Maximum number of events allowed
      - `aiApiQuota` AIAPIQuotaLimit
        - `timeUnit` string, required — Unit of the time. Allowed values are "sec", "min", "hour", "day"
        - `unitTime` integer, required — Time limit that the throttling limit applies.
        - `requestCount` integer, required — Maximum number of requests allowed
        - `totalTokenCount` integer — Maximum number of total tokens allowed
        - `promptTokenCount` integer — Maximum number of prompt tokens allowed
        - `completionTokenCount` integer — Maximum number of completion tokens allowed
  - `pagination` Pagination
    - `offset` integer
    - `limit` integer
    - `total` integer
    - `next` string — Link to the next subset of resources qualified. Empty if no more resources are to be returned.
    - `previous` string — Link to the previous subset of resources qualified. Empty if current subset is the first subset returned.

## Other responses

- `default` — Unexpected error

## Changes

- **2025-04-03** `eb07388f2892` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `default`
- **2024-01-29** `f2e9e07fd354` — 2 breaking
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `default`

[Change history](https://skmtc.dev/wso2/apis/internal-utility-api/changes/subscription-policies/get.md)

---

[API](https://skmtc.dev/wso2/apis/internal-utility-api.md) · [All operations](https://skmtc.dev/wso2/apis/internal-utility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wso2/internal-utility-api/revisions/0be9aa8493bc/schema)