Skip to content
bucker

API reference

pricing.json

1 operation. Shapes are sketches of the declared schemas, bounded in depth — the authoritative document is linked from the index.

GET/pricing.json

No declared credential scheme

Reachable without a Bucker session token. The price list in force, the version announced next with what it changes, and the history of published versions. The same document the website pricing page is generated from; weights are the weights register’s.

Response 200

{
  schemaVersion: 1
  version: string
  effectiveFrom: string
  digest: string
  currency: "USD"
  interval: "calendar_month"
  noticeDays: integer
  principles: string[]
  annualTerm: {
    monthsBilled: integer
    monthsFree: integer
    selfServe: boolean
  }
  trial: {
    tier: "FREE" | "PRO" | "TEAM" | "ENTERPRISE"
    days: integer
    requiresPaymentMethod: boolean
    oncePerOrg: boolean
  }
  plans: {
    tier: "FREE" | "PRO" | "TEAM" | "ENTERPRISE"
    name: string
    monthlyPriceCents: integer | null
    includedUnitsPerMonth: integer
    retentionDays: integer
    includedVerifiedFixes: integer
    perVerifiedFixCents: integer
    aiFairUse: {
      tokensPerMonth: integer
      sandboxMinutesPerMonth: integer
    }
  }[]
  weights: {
    decision: string
    unit: string
    categories: {
      category: string
      weight: number
      status: string
    }[]
  }
  examples: {
    id: string
    title: string
    tier: "FREE" | "PRO" | "TEAM" | "ENTERPRISE"
    usage: Record<string, number>
    units: number
    includedUnitsPerMonth: integer
    percentOfIncluded: number
    monthlyPriceCents: integer | null
  }[]
  source: "published" | "enforced"
  inForceVersion: string
  next: {
    version: string
    kind: "price_list" | "weights_register"
    noticeFrom: string
    effectiveFrom: string
    daysUntilEffective: integer
    changes: {
      tier: "FREE" | "PRO" | "TEAM" | "ENTERPRISE"
      field: string
      from: number | null
      to: number | null
    } | {
      category: string
      from: number | null
      to: number | null
    }[]
  } | null
  history: {
    version: string
    kind: "price_list" | "weights_register"
    noticeFrom: string
    effectiveFrom: string
    digest: string
    publishedAt: string
    state: "effective" | "announced" | "superseded"
  }[]
}

Response 429 · `rate_limited` or `quota_exceeded` — over a ceiling. `Retry-After` says when to come back, and `x-ratelimit-limit` / `-remaining` / `-reset` describe the bucket.

{
  error: {
    code: "bad_request" | "conflict" | "forbidden" | "internal_error" | "mfa_required" | "not_found" | "payload_too_large" | "quota_exceeded" | … 6 more
    message: string
    details?: unknown
    requestId?: string
  }
}

Response 500 · `internal_error` — an unhandled failure on this side. The message is always generic; `requestId` is the part worth quoting.

{
  error: {
    code: "bad_request" | "conflict" | "forbidden" | "internal_error" | "mfa_required" | "not_found" | "payload_too_large" | "quota_exceeded" | … 6 more
    message: string
    details?: unknown
    requestId?: string
  }
}

Request

curl https://api.bucker.io/pricing.json