> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Saldo crediti API: fatturazione KYC con Didit > Recupera il saldo crediti Didit e le impostazioni di ricarica automatica. Un unico saldo copre tutti i prodotti, dai crediti del piano alle ricariche. Prompt per ottenere il saldo del credito Copia il prompt negli appunti \

\`Goal: Read the organization's current pre-paid credit balance (USD) plus its auto-refill configuration.

Endpoint: GET https://verification.didit.me/v3/billing/balance/
Auth header: x-api-key: 

curl:
curl -X GET 'https://verification.didit.me/v3/billing/balance/' \
-H 'x-api-key: YOUR_API_KEY'

Response 200:
\{
"balance": "1234.5600",                  // USD, FIXED-POINT DECIMAL STRING — parse with Decimal/BigDecimal, not float.
"auto_refill_enabled": true,             // boolean
"auto_refill_amount": "500.00",          // USD string or null
"auto_refill_threshold": "100.00"        // USD string or null — auto-refill fires when balance falls below this
}

Notes:
\- Balance is ORGANIZATION-WIDE — shared across every application under the same org.
\- Decreases as verifications are billed; increases when a top-up settles via Stripe webhook.
\- Currency is always USD.
\- Configure auto-refill in Console → Billing; requires a saved Stripe payment method (card, SEPA, or US ACH). The auto-refill amount is $50 to $20,000, added at face value, the same range as a manual top-up.
\- Poll at a low cadence (every few minutes max) — balance only changes when usage is billed or a top-up settles.

Common patterns:
\- Gate session creation in production — stop opening new sessions if balance drops below your operational floor.
\- Power internal dashboards / low-balance alerts.
\- Detect misconfigured auto-refill: auto_refill_enabled=true with null auto_refill_amount/threshold means it's effectively off (or no eligible payment method on file).

Failure modes (envelope {"detail": "..."}):
\- 401 — missing/malformed x-api-key.
\- 403 — key valid but bound application not allowed to read billing.
\- 429 — rate-limited.

See /getting-started/pricing for the credit consumption model and POST /v3/billing/top-up/ to add funds programmatically.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
Incolla in ## OpenAPI ````yaml it/openapi-25.json GET /v3/billing/balance/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/billing/balance/: get: tags: - Billing summary: Recupera saldo crediti description: >- Recupera il saldo attuale dei crediti prepagati in USD (a livello di organizzazione) e la configurazione di ricarica automatica. Gli importi sono stringhe decimali: analizzali con una libreria per numeri decimali. operationId: get_billing_balance responses: '200': description: >- Saldo crediti attuale più la configurazione di ricarica automatica dell'organizzazione. content: application/json: schema: type: object required: - balance - auto_refill_enabled properties: balance: type: string description: >- Saldo attuale dei crediti prepagati in USD, come stringa decimale a virgola fissa. Diminuisce man mano che le verifiche vengono fatturate e aumenta quando una ricarica va a buon fine. auto_refill_enabled: type: boolean description: >- Quando è `true`, Didit addebiterà automaticamente il metodo di pagamento salvato per aggiungere crediti non appena il saldo supera `auto_refill_threshold`. Si configura da Console → Fatturazione. auto_refill_amount: type: string nullable: true description: >- Importo in USD che verrà addebitato e aggiunto al saldo a ogni ricarica automatica, al valore nominale. Impostabile da \$50 a \$20,000 in Console → Fatturazione. `null` quando la ricarica automatica è disabilitata o non impostata. auto_refill_threshold: type: string nullable: true description: >- Soglia di trigger in USD. La ricarica automatica si attiva quando `balance` scende al di sotto di questo valore. `null` quando la ricarica automatica è disabilitata o non impostata. examples: Healthy balance with auto-refill: value: balance: '1234.5600' auto_refill_enabled: true auto_refill_amount: '500.00' auto_refill_threshold: '100.00' Low balance, manual top-up only: value: balance: '12.0000' auto_refill_enabled: false auto_refill_amount: null auto_refill_threshold: null '403': description: >- Chiave API mancante, non valida o revocata, oppure la chiave non può leggere i dati di fatturazione per questa organizzazione. Una chiave mancante restituisce `403`; una chiave errata, revocata o scaduta restituisce `401`. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '429': description: >- Limite di frequenza superato; rallenta e riprova dopo l'intervallo indicato in `Retry-After`. content: application/json: examples: Throttled: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X GET 'https://verification.didit.me/v3/billing/balance/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.billing.retrieve_balance() print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.billing.retrieveBalance(); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Billing.RetrieveBalance(ctx)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.billing().retrieveBalance(); System.out.println(result); - lang: php label: PHP source: |- billing->retrieveBalance(); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.billing.retrieve_balance puts result.to_h - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Billing.RetrieveBalanceAsync(); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.