---
title: "Get Box limits"
method: GET
path: "/limits"
tags: ["Box"]
---

# Get Box limits

`GET /limits`

Check quota, access readiness, and active-box capacity for the authenticated account.

## Response `200`

Current creation and active-box limits.

- LimitsResponse
  - `ok` boolean, required
  - `type` string, required — Stable success envelope discriminator added by v1.
  - `accessTier` string
  - `blockedReason` string, nullable
  - `currentLimits` object
    - `activeBoxes` integer
    - `creationRatePerMinute` integer
    - `creationRequestsPerDay` integer, nullable
  - `standardLimits` object
    - `activeBoxes` integer
    - `creationRatePerMinute` integer
    - `creationRequestsPerDay` integer, nullable
  - `trialLimits` object
    - `activeBoxes` integer
    - `creationRatePerMinute` integer
    - `creationRequestsPerDay` integer, nullable
  - `upgradeEffects` object
  - `canStart` boolean, required — Whether the authenticated account can create or operate boxes right now.
  - `checkoutRequired` boolean
  - `startBlockedReason` string, nullable
  - `contactMessage` string, nullable
  - `activeBoxes` integer, required
  - `activeStates` string[]
  - `maxActiveBoxes` integer, required
  - `maxCreationRequestsPerMinute` integer
  - `maxCreationRequestsPerDay` integer, nullable
  - `hasPaymentHistory` boolean
  - `package` object
  - `subscriptionQuotaSeconds` integer
  - `subscriptionRemainingSeconds` integer
  - `packBalanceSeconds` integer
  - `creditPurchasedSeconds` integer
  - `creditUsedSeconds` integer
  - `liveUsageSeconds` integer
  - `creditSecondsPerDollar` integer
  - `billingStatus` string, required — Account access state returned by the current backend. Billing endpoints are not part of v1.
  - `subscriptionStatus` string, nullable
  - `subscriptionCancelAtPeriodEnd` boolean
  - `hasSubscription` boolean
  - `subscriptionTrialEndsAt` string, date-time, nullable
  - `subscriptionCurrentPeriodEnd` string, date-time, nullable
  - `creditBalanceSeconds` integer

## Other responses

- `401` — Missing or invalid bearer token.

---

[API](https://skmtc.dev/ascii/apis/box-public-api-v1.md) · [All operations](https://skmtc.dev/ascii/apis/box-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ascii/box-public-api-v1/revisions/82d576f82046/schema)