Astrocal
API ReferenceUsageV1Usage

Get API usage and limits

Returns the current plan tier, rate limits, usage counters, and reset times for the authenticated organization.

GET
/v1/usage

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/usage"
{
  "tier": "free",
  "limits": {
    "api_calls_per_minute": 0,
    "api_calls_per_day": 0,
    "bookings_per_month": 0
  },
  "usage": {
    "api_calls_today": 0,
    "api_calls_remaining_daily": 0,
    "bookings_this_month": 0,
    "bookings_remaining_monthly": 0
  },
  "reset_at": {
    "daily": "string",
    "monthly": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Delete all test data

Deletes all test event types, availability rules, and bookings for the authenticated organization. Only works with test API keys (ac_test_*). Returns 400 if called with a live key.

Get usage summary metrics

Returns aggregate usage statistics for the authenticated organization over a specified period. Data is derived from existing tables. API call counts may undercount for periods beyond 48 hours due to the rate limit window cleanup job.