> ## Documentation Index > Fetch the complete documentation index at: https://docs.trynito.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get billing balance > Read the credential organization's available credit and top-up projection in integer USD nanos strings. API keys require admin=true and current owner/admin membership; existing CLI inference OAuth tokens require current owner/admin membership. Cookies alone are rejected. X-Org-ID must match the credential organization. Uses spa_api_account_org limits, independent of inference limits and funding eligibility. Missing balance accounts return zero. Projection failures preserve available_nanos but omit top-up amounts and set top_up_projection_state to unavailable. No provider costs are exposed. See the [guide](/api/api-reference/usage/get-balance) for permissions, examples, and response semantics. ## OpenAPI ````yaml openapi.json GET /api/v1/billing/balance openapi: 3.1.0 info: contact: email: developers@trynito.ai name: Nito Developer Support url: https://docs.trynito.ai/support description: >- Nito developer API: inference, Fusion, model catalog, attestation, web retrieval, document parsing, API key management, balance, rate-limit snapshots, and MCP. termsOfService: https://trynito.ai/terms title: Nito API version: '2026-07-01' servers: - description: Configured gateway url: https://app.trynito.ai security: [] tags: - description: >- OpenAI Chat Completions-compatible inference routes backed by gateway routing, billing, privacy, and streaming controls. name: Chat - description: >- Stateless OpenAI Responses-compatible shims for agent clients, including the compact output-item endpoint used by standalone compaction flows. name: Responses - description: >- Anthropic Messages-compatible request, response, token-count, and streaming surfaces mapped into canonical gateway contracts. name: Messages - description: >- Model discovery and browser model-picker metadata for safe logical model selection. name: Models - description: >- Request-local Attestation metadata for supported Attestable models in the Confidential and Encrypted tiers. name: Attestation - description: >- Streamable HTTP MCP transport documented with resource-bound bearer-token authentication. name: MCP - description: >- Standalone, credential-authenticated web search and fetch without an inference model. name: Web - description: >- OAuth-authorized organization API key administration with explicit consent and current owner/admin authorization. name: API Keys - description: >- Browser billing, usage, referral, balance, auto top-up, and x402 funding surfaces using integer nanos. name: Billing externalDocs: description: Nito developer documentation url: https://docs.trynito.ai/nito paths: /api/v1/billing/balance: get: tags: - Billing summary: Get the credential organization's credit balance description: >- Read the credential organization's available credit and top-up projection in integer USD nanos strings. API keys require admin=true and current owner/admin membership; existing CLI inference OAuth tokens require current owner/admin membership. Cookies alone are rejected. X-Org-ID must match the credential organization. Uses spa_api_account_org limits, independent of inference limits and funding eligibility. Missing balance accounts return zero. Projection failures preserve available_nanos but omit top-up amounts and set top_up_projection_state to unavailable. No provider costs are exposed. operationId: getBillingBalance responses: '200': content: application/json: example: available_nanos: '1000000000' top_up_projection_state: available top_up_remaining_nanos: '1000000000' top_up_spent_nanos: '1000000000' schema: $ref: '#/components/schemas/OrgBillingBalance' description: OK headers: Cache-Control: description: Billing responses must not be cached. example: no-store schema: type: string '400': content: application/json: example: error: code: invalid_request message: The request is invalid. schema: $ref: '#/components/schemas/ErrorResponse' description: Invalid request headers: Cache-Control: description: Billing responses must not be cached. example: no-store schema: type: string '401': content: application/json: example: error: code: unauthorized message: authentication required schema: $ref: '#/components/schemas/ErrorResponse' description: Authentication required headers: Cache-Control: description: Billing responses must not be cached. example: no-store schema: type: string '403': content: application/json: example: error: code: forbidden message: credential is not authorized for this operation schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden headers: Cache-Control: description: Billing responses must not be cached. example: no-store schema: type: string '429': content: application/json: examples: insufficient_quota: summary: Billing balance or free-tier quota exhausted value: error: code: insufficient_quota message: insufficient billing balance rate_limited: summary: Gateway or provider rate limit exceeded value: error: code: rate_limited message: rate limited schema: $ref: '#/components/schemas/ErrorResponse' description: Rate limited or insufficient quota headers: Cache-Control: description: Billing responses must not be cached. example: no-store schema: type: string Retry-After: description: >- Seconds to wait before retrying when the gateway can compute a retry window. example: '60' schema: type: string X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' '500': content: application/json: example: error: code: internal_error message: internal error schema: $ref: '#/components/schemas/ErrorResponse' description: Internal server error headers: Cache-Control: description: Billing responses must not be cached. example: no-store schema: type: string '503': content: application/json: example: error: code: unavailable message: service unavailable schema: $ref: '#/components/schemas/ErrorResponse' description: Service unavailable headers: Cache-Control: description: Billing responses must not be cached. example: no-store schema: type: string security: - PublicApiBearer: [] - PublicApiKeyHeader: [] - CliOAuthBearer: [] components: schemas: OrgBillingBalance: description: >- Schema for `OrgBillingBalance` values returned by or accepted by the Nito gateway. example: available_nanos: '1000000000' top_up_projection_state: available top_up_remaining_nanos: '1000000000' top_up_spent_nanos: '1000000000' properties: available_nanos: description: The `available_nanos` field on `OrgBillingBalance`. example: '1000000000' pattern: ^[0-9]+$ type: string top_up_projection_state: description: The `top_up_projection_state` field on `OrgBillingBalance`. enum: - available - unavailable example: available type: string top_up_remaining_nanos: description: The `top_up_remaining_nanos` field on `OrgBillingBalance`. example: '1000000000' pattern: ^[0-9]+$ type: string top_up_spent_nanos: description: The `top_up_spent_nanos` field on `OrgBillingBalance`. example: '1000000000' pattern: ^[0-9]+$ type: string required: - available_nanos - top_up_projection_state type: object ErrorResponse: description: >- Schema for `ErrorResponse` values returned by or accepted by the Nito gateway. example: error: code: invalid_request message: The request is invalid. param: model properties: error: $ref: '#/components/schemas/Error' description: The `error` field on `ErrorResponse`. example: example required: - error type: object Error: description: Schema for `Error` values returned by or accepted by the Nito gateway. example: code: example message: example operation_id: 00000000-0000-4000-8000-000000000001 param: example properties: code: description: The `code` field on `Error`. example: example type: string message: description: The `message` field on `Error`. example: example type: string operation_id: description: The `operation_id` field on `Error`. example: 00000000-0000-4000-8000-000000000001 type: string param: description: The `param` field on `Error`. example: example type: string required: - message - code type: object headers: RateLimitLimit: description: Maximum requests for the controlling gateway request-rate bucket. schema: type: string RateLimitRemaining: description: >- Additional requests immediately available in the controlling gateway request-rate bucket. schema: type: string RateLimitReset: description: >- UTC Unix epoch seconds, rounded up, when the controlling gateway request-rate bucket is fully replenished. schema: type: string securitySchemes: PublicApiBearer: description: 'Org API key as Authorization: Bearer z_sk_...' scheme: bearer type: http PublicApiKeyHeader: description: Org API-key compatibility header. CLI and MCP tokens are rejected here. in: header name: X-API-Key type: apiKey CliOAuthBearer: description: 'OAuth CLI access token as Authorization: Bearer nito_cli_...' scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.