---
search:
  tags:
    - billing
    - GET
seo:
  description: >-
    Billing (billing_enabled) is on for a new org from the start of its trial,
    at signup or once… Reference for the GET /v1/balance endpoint in the pols.so
    API.
sidebar:
  label: The org's credit balance and the credit it was granted
  badge: GET
title: The org's credit balance and the credit it was granted
type: openapi-operation
---
Billing (`billing_enabled`) is on for a new org from the start of
its trial, at signup or once its signup is approved; an existing org has it off
until an operator switches it on (`polsd admin set-billing`).
While it is off, usage is metered and shown but not charged, nothing is
refused or stopped for lack of credit, and the org's monthly
sandbox-hours quota (`monthly_sandbox_hours` on `/v1/org`) caps
its usage instead. Once it is on, the org pays
its usage from credit: each hour's priced usage (`/v1/usage`) is taken from its
credit once the hour is over, from the credit that expires first,
prepaid credit last. `available_eur` is that credit, less any debt
and the usage not yet taken from it, so it falls while sandboxes
run. At zero, running sandboxes are stopped (their disks are kept)
and none can start (402 `insufficient_credit`) until it is positive
again; disk above the free allowance keeps costing, and what the
credit cannot pay becomes debt, taken first from the next credit.

`GET /v1/balance`