---
title: "Read screenshot quota and usage"
method: GET
path: "/steam/api/screenshot/usage"
tags: ["Screenshot"]
---

# Read screenshot quota and usage

`GET /steam/api/screenshot/usage`

## Request

- Base URL: `https://www.steamwebapi.com`
- URL: `https://www.steamwebapi.com/steam/api/screenshot/usage`
- Auth: one of:
  - API key in query parameter `key`
  - API key in header `X-Api-Key`
  - API key in header `Key`

Available in every package. Initializes access if needed using Screenshot limits or the package Global fallback. Separate screenshot request counters; render retries and result retrieval also count. Day/month windows use UTC calendar boundaries. total covers retained usage history, not necessarily lifetime usage. Load on demand and respect Retry-After; do not poll for every screenshot.

## Query parameters

- `key` string

## Response `200`

Current screenshot quota and consumption. A null limit means unlimited.

- object
  - `status` 'success', required
  - `active` boolean, required
  - `limits` object, required
    - `minute` integer, nullable, required
    - `day` integer, nullable, required
    - `month` integer, nullable, required
  - `usage` object, required
    - `minute` integer, required
    - `day` integer, required
    - `month` integer, required
    - `total` integer, required
    - `blocked` integer, required
  - `timezone` 'UTC', required
  - `period` 'calendar', required
  - `unit` 'authenticated_requests', required

## Other responses

- `401`: Missing or invalid SteamWebAPI key.
- `402`: Current package does not allow screenshot registration.
- `403`: Screenshot access is disabled.
- `409`: Key registration conflict; contact support.
- `429`: Usage retrieval is temporarily rate limited; respect Retry-After.
- `502`: Invalid usage response.
- `503`: Screenshot access initialization or usage is unavailable.

---

[API](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation.md) · [All operations](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/revisions/f9a4109cbda6?raw)