Check quotas

Check usage against all matching quotas for the given dimensions without consuming quota.

This endpoint allows you to query quota status without actually recording usage. Useful for:

  • Pre-flight checks before processing requests
  • Displaying quota status to users
  • Monitoring quota consumption

Dimension Matching: Quotas are matched based on dimension filters. Pass dimensions like:

  • customer_id: Filter by customer
  • event_type: Filter by event type
  • model: Filter by model
  • provider: Filter by provider
  • Any custom dimension from event properties
POST
/quotas/check
AuthorizationBearer <token>

Project API key

In: header

Request Body

application/json

[key: string]?unknown

Response Body

application/json

application/json

curl -X POST "https://api.limitry.com/v1/quotas/check" \  -H "Content-Type: application/json" \  -d '{    "property1": null,    "property2": null  }'
{
  "allowed": true,
  "quotas": [
    {
      "id": "qta_abc123",
      "name": "Daily Token Limit",
      "metric": "total_tokens",
      "period": "day",
      "limit": 100000,
      "used": 45230,
      "remaining": 54770,
      "exceeded": false
    }
  ]
}
{
  "error": "Invalid or missing API key"
}