Get Usage Limits
Usage & Billing
Get Usage & Billing Limits
Returns your current billing cycle usage for storage, folders, presets, and transformations.
GET
Get Usage Limits
Understanding Your Limits
Every API request or dashboard action that interacts with your project’s storage or transformation engine increments your billing counters. Dreep’s architecture restricts operations when you exceed your billing plan. If you attempt to upload a file when your storage is full, or transform an image when you’ve hit your monthly transformation cap, the API will reject the request with a402 Payment Required status code.
The Counters
When you call this endpoint, you will receive thelimits and counters objects which contain:
- Storage Bytes: The total raw binary size of all assets stored in your project (in bytes). This is persistent.
- Transformations Monthly: The number of image transformations triggered this month. Resets on the 1st of every month.
- Video Transformations Monthly: The number of video transformations triggered this month. Resets on the 1st of every month. Video transformations count separately from image transformations because they are heavily CPU-intensive.
- Folders: Total number of folders created.
- Presets: Total number of transformation presets created.
402 Payment Required Error
If you hit an API endpoint that would exceed one of your limits, the response will look like this:Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.