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

# Get all API throttling policies

`GET /api-policies`

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

## Query parameters

- `policyName` string

## Headers

- `xWSO2Tenant` string, required

## Response `200`

An array of api policies in the database

- ApiPolicyList
  - `count` integer — Number of Api Policies returned.
  - `list` ApiPolicy[]
    - `id` integer
    - `tenantId` integer
    - `tenantDomain` string
    - `name` string
    - `quotaType` string
    - `conditionGroups` ApiPolicyConditionGroup[]
      - `policyId` integer
      - `quotaType` string
      - `conditionGroupId` integer
      - `condition` Condition[]
        - `conditionType` string
        - `name` string
        - `value` string
        - `isInverted` 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
    - `applicableLevel` string
    - `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/api-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)