Get subscription

GET/v1/billing/subscriptionSDK: billing.getSubscription

Returns the organization's current plan (free, pro, or enterprise), the billing period window, and the limits that apply. Free orgs always return plan: "free" with periodStart and periodEnd set to null.

Example request

import { Buckt } from "@buckt/sdk";

const client = new Buckt({ apiKey: process.env.BUCKT_API_KEY });

const subscription = await client.billing.getSubscription();

Responses

{
  "data": {
    "plan": "pro",
    "status": "active",
    "limits": {
      "maxBuckets": 10,
      "maxStorageBytes": 107374182400,
      "maxBandwidthBytesPerMonth": 1099511627776,
      "maxRequestsPerMinute": 1000
    },
    "periodStart": "2026-04-01T00:00:00Z",
    "periodEnd": "2026-05-01T00:00:00Z",
    "cancelAtPeriodEnd": false
  },
  "error": null,
  "meta": null
}