---
title: "Get the workspace's rate limit tier"
method: GET
path: "/rate-limits/tier"
tags: ["Gateway"]
---

# Get the workspace's rate limit tier

`GET /rate-limits/tier`

## Request

- Base URL: `https://api.phaseo.app/v1`
- URL: `https://api.phaseo.app/v1/rate-limits/tier`
- Auth: HTTP bearer

Returns the workspace's trust tier, its requests per minute, and whether it can raise itself one tier now. Workspace owners and admins (OAuth) or management keys with rate_limits:read. canRaise is true only for the workspace owner.

## Response `200`

Tier and raise status

- RateLimitTierResponse
  - `data` object, required
    - `tier` string
    - `requestsPerMinute` number
    - `target` string, nullable: The tier a raise would move to.
    - `targetRequestsPerMinute` number, nullable
    - `eligible` boolean
    - `refusal` string, nullable: Why a raise is not available now; null when eligible.
    - `activeUntil` number, nullable: When an active raise ends (Unix milliseconds).
    - `availableAt` number, nullable: When the next raise may be requested (Unix milliseconds).
    - `durationDays` number
    - `thresholds` object
      - `minAgeDays` number
      - `minLifetimePaidSpendUsd` number
    - `canRaise` boolean: True when the caller is the workspace owner and the workspace is eligible.

## Other responses

- `401`: Unauthorized
- `403`: Not an owner or admin, or token lacks rate_limits:read

## Changes

- **2026-10-28** `72ba9c856a2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/changes/rate-limits/tier/get.md)

---

[API](https://skmtc.dev/phaseo/apis/phaseo-gateway-api.md) - [All operations](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/revisions/5ca9bb220d25?raw)