Founder's PriceUp to 53% off Pro, Business and Enterprise for our first customers, locked in while you stay subscribed paid plans30 spots leftClaim your spot
DocsUsage and limits

Docs / API reference

Usage and limits

Your plan's limits and how much you've used today and this month.

Request

GEThttps://tcgpriceapi.com/v1/usage

Free: checking your usage never counts as a request.

Request
curl "https://tcgpriceapi.com/v1/usage" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Response 200
{
  "plan": "Free",
  "tier": "lowest",
  "limits": {
    "requests_per_day": 100,
    "requests_per_month": 1500,
    "requests_per_minute": 10,
    "cards_per_request": 1,
    "history_cards_per_request": 1,
    "history_days": 7,
    "cards_per_day": null
  },
  "used": {
    "requests_today": 12,
    "cards_today": 40,
    "history_cards_today": 2,
    "requests_this_month": 230
  }
}

The limits are the Free plan's; the used numbers are an illustration.

FieldTypeDescription
planstringYour plan, such as "Free" or "Pro".
tierstringYour plan's internal name.
limitslimits object
usedused object

limits

FieldTypeDescription
requests_per_dayintegerRequests allowed each day (UTC).
requests_per_monthintegerRequests allowed each month (UTC).
requests_per_minuteintegerRequests allowed in one calendar minute (UTC). Going over gets a 429 answer with a Retry-After header.
cards_per_requestintegerThe most cards one current-price request can ask for.
history_cards_per_requestintegerThe most cards one history request can ask for.
history_daysintegerThe longest sold history your plan includes, in days: 7 on Free, 30 on Starter, 365 on Pro and up.
cards_per_dayinteger or nullCards allowed each day (UTC), counting prices, history and scans together. null when your plan has no card limit.

used

FieldTypeDescription
requests_todayintegerRequests counted today (UTC).
cards_todayintegerCards looked up for current prices today (history lookups are counted in history_cards_today). Shown for your records; only requests are limited.
history_cards_todayintegerCards whose history was looked up today.
requests_this_monthintegerRequests counted this month (UTC).