> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eversince.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# account balance

> The three balances, in the tool envelope: the same answer as POST /tools/get_balance.



## OpenAPI

````yaml /openapi.json get /account/balance
openapi: 3.1.0
info:
  title: Eversince API
  version: '1'
  description: >-
    Every Eversince tool as one POST call, plus the routes beside them: the tool
    list, account and keys, uploads, webhooks and models. The prose is at
    https://docs.eversince.ai.
servers:
  - url: https://eversince.ai/api/v1
security:
  - bearer: []
tags:
  - name: Discovery
    description: The tool list, the same on the MCP server, the REST API and the CLI.
  - name: Workspace
    description: Jobs, balances, settings, templates, skills and the overview.
  - name: Library
    description: >-
      Items, search, import, reading media, comments, boards, calendars, the
      brand kit and public links.
  - name: Timeline
    description: 'Video editing: timelines, clips, captions, sound, language and rendering.'
  - name: Canvas
    description: 'Still editing: canvases, slides, layers and rendering.'
  - name: Generation
    description: Image, video and audio generation, upscaling, cutouts and models.
  - name: Research
    description: 'What platforms publish: pulling and keeping posts.'
  - name: Account
    description: Balances, keys, workspaces and script sessions.
  - name: Uploads
    description: Files into the library by presigned upload or by URL.
  - name: Webhooks
    description: Job results posted to a URL as they complete.
  - name: Models
    description: Generation models and cost estimates.
paths:
  /account/balance:
    get:
      tags:
        - Account
      summary: account balance
      description: >-
        The three balances, in the tool envelope: the same answer as POST
        /tools/get_balance.
      operationId: account_balance
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    const: true
                  data:
                    type: object
                    properties:
                      plan:
                        type: string
                      ai_credits:
                        type: object
                        properties:
                          balance:
                            type: number
                          next_expiry:
                            type: object
                            properties:
                              amount:
                                type: number
                              'on':
                                type: string
                      cloud_minutes:
                        type: object
                        properties:
                          available:
                            type: number
                          month_included:
                            type: number
                          month_used:
                            type: number
                          month_left:
                            type: number
                          renews_at:
                            type: string
                          bought:
                            type: number
                          frozen:
                            type: boolean
                      storage:
                        type: object
                        properties:
                          unit:
                            const: bytes
                          used:
                            type: number
                          limit:
                            type: number
                          left:
                            type: number
                          owner:
                            type: boolean
                      top_up:
                        type: object
                        properties:
                          in_app:
                            type: string
                          url:
                            type: string
                  meta:
                    type: object
                    properties:
                      request_id:
                        type: string
                required:
                  - ok
                  - data
                  - meta
        default:
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: The call was refused or failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - ok
        - error
      properties:
        ok:
          const: false
        error:
          type: object
          required:
            - code
            - message
            - retryable
          properties:
            code:
              type: string
            message:
              type: string
              description: What went wrong, in words to act on.
            retryable:
              type: boolean
            suggested_action:
              type: string
              description: The next step that works.
            cloud_processing:
              $ref: '#/components/schemas/CloudProcessing'
    CloudProcessing:
      type: object
      description: Cloud processing the call used, and what is left.
      properties:
        ran_on:
          const: cloud
        minutes:
          type: number
        queued_minutes:
          type: number
        left_minutes:
          type: number
        bought_minutes:
          type: number
        note:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        An API key (es_live_…) from Settings, under API keys, or an OAuth access
        token.

````