---
title: "Advance one pending billing policy"
method: POST
path: "/v1/billing/reconcile"
---

# Advance one pending billing policy

`POST /v1/billing/reconcile`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/billing/reconcile`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

Advances at most one due, already-authorized desired billing-policy revision for the caller's organization into PostgreSQL, then returns the same exact desired/effective summary as billing.summary. The command never changes the desired document. A transport failure is recorded for bounded retry and remains pending. Repeating the command may advance the next queued revision, so each call requires approval.

## Response `200`

Advance one pending billing policy

- object
  - `activation` object, required
    - `boundary` string, required
    - `mode` 'disabled' | 'shadow' | 'enforced', required
  - `blockingReasons` string[], required
  - `budgetPolicy` object, required
    - `desired` object, required
      - `advisoryBudget` object, nullable, required
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
      - `hardCap` object, nullable, required
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
    - `desiredRevision` integer, required
    - `effectiveRevision` integer, required
    - `pending` boolean, required
  - `closedAt` string
  - `credit` object, required
    - `available` object, required
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `consumed` object, required
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `reserved` object, required
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `byKind` object
      - `purchased` object, required
        - `available` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `reserved` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `consumed` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `forfeited` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `granted` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `expiresAt` string
      - `trial` object, required
        - `available` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `reserved` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `consumed` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `forfeited` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `granted` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `expiresAt` string
      - `promotional` object, required
        - `available` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `reserved` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `consumed` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `forfeited` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `granted` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `expiresAt` string
  - `desiredRevision` integer, required
  - `effectiveRevision` integer, required
  - `freshness` object, required
    - `kind` 'authoritative', required
  - `includedProject` string
  - `period` object
    - `advisoryBudget` object
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `hardCap` object
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `remainingToHardCap` object
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `advisoryBudgetProgress` object
      - `committed` object, required
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
      - `remaining` object, required
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
    - `automaticExecutionTopUp` object, required
      - `cap` object
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
      - `pending` object, required
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
      - `remainingToCap` object
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
      - `settled` object, required
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
    - `subscribedProjectFees` object, required
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `reservedUsage` object, required
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `settledUsage` object, required
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `start` string, required
    - `end` string, required
  - `pending` boolean, required
  - `priceVersion` string, required
  - `trialExpiresAt` string

## Other responses

- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing, test_to_live_escalation.
- `409`: Problem document. Possible codes at this status: project_archived.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: billing_not_ready, capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)