---
title: "Get Gateway Status"
method: GET
path: "/api/gateway/status"
tags: ["Gateway"]
---

# Get Gateway Status

`GET /api/gateway/status`

Get current usage status for Context-Gateway CLI display.

**Requires API key authentication** (any valid COMPRESR_API_KEY)

Returns lightweight status summary:
- Credits remaining (subscription + wallet combined)
- Usage percentage of monthly budget
- Tier information
- Request counts

Used by Context-Gateway to display a persistent status bar showing
the user's balance and usage during operation.

## Headers

- `X-API-Key` string, required

## Response `200`

User's usage status for gateway display

- GatewayStatusResponse
  - `success` boolean
  - `message` string, nullable
  - `data` GatewayStatusResult — Usage status for Context-Gateway CLI display. Provides a lightweight summary for the gateway to display balance and usage info to users during operation.
    - `tier` string — Rate-limit tier: tier1, tier2, tier3, tier4, tier5
    - `credits_remaining_usd` number — Total remaining credits (subscription + wallet) in USD
    - `credits_used_this_month` number — Credits used this billing month in USD
    - `monthly_budget_usd` number — Monthly budget/allocation in USD (0 = unlimited for admins)
    - `usage_percent` number — Percentage of monthly budget used (0-100)
    - `requests_today` integer — Number of compression requests today
    - `requests_this_month` integer — Number of compression requests this billing month
    - `daily_request_limit` integer, nullable — Daily request limit (None = unlimited)
    - `is_admin` boolean — Whether user has admin/unlimited access

## Other responses

- `401` — Unauthorized - requires API key
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/compresr/apis/compresr-platform-api.md) · [All operations](https://skmtc.net/compresr/apis/compresr-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/compresr/compresr-platform-api/versions/93ee959dfa51/schema)