---
title: "API key quota and usage breakdown"
method: GET
path: "/daas/usage"
tags: ["Account"]
---

# API key quota and usage breakdown

`GET /daas/usage`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/daas/usage`
- Auth: API key in header `X-PlayCaller-Key`

Returns current quota consumption, rate limits, tier details, and per-endpoint call breakdown for the authenticated key. Use this to build usage dashboards or trigger pre-quota alerts in your application.

**Tier access:** Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha

## Response `200`

API key usage statistics — flat object, not wrapped in `data`

- UsageStats
  - `success` boolean
  - `key_prefix` string
  - `tier` 'sandbox' | 'hobbyist' | 'build' | 'growth' | 'pro' | 'pro_insights' | 'enterprise' | 'syndicate_alpha'
  - `tier_limits` object: Reference limits for every legacy tier (V2 tiers are not monthly-metered, so they are not listed here — see GET /v1/sports or the pricing table for sandbox/build/pro_insights/syndicate_alpha caps)
  - `is_trial` boolean
  - `trial_starts_at` string, date-time, nullable
  - `trial_ends_at` string, date-time, nullable
  - `trial_days_remaining` integer, nullable: Days left in trial (null if not in trial)
  - `requests_today` integer
  - `daily_limit` integer, nullable
  - `daily_remaining` integer, nullable
  - `calls_this_period` integer
  - `calls_this_month` integer
  - `calls_limit_month` integer
  - `calls_remaining` integer
  - `rate_limit_per_min` integer
  - `rate_limit_remaining` integer
  - `reset_at` string, date-time, nullable: When monthly quota resets (legacy tiers only — null for V2 tiers, which are not monthly-metered)
  - `upgrade_url` string, uri, nullable
  - `endpoint_breakdown` object[]: Per-endpoint call counts for the trailing 30 days — an array of rows, not a map (returned empty for RapidAPI-proxied keys, which have no DB usage row)
    - `endpoint` string
    - `calls` integer
    - `avg_ms` integer
    - `last_call` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)
