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

# Retrieve Account Balance

> Get Account Balance

<Note>
  If the merchant has not yet received a successful payment or deposit, this endpoint returns `404` with the message: `No balance account is linked to this merchant yet. Balance becomes available after the first successful payment or deposit.`
</Note>


## OpenAPI

````yaml GET /account/balance
openapi: 3.0.1
info:
  title: CORE API OpenAPI Specification
  description: This is the API documentation for the ClickPesa CORE API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.clickpesa.com/third-parties
security:
  - bearerAuth: []
paths:
  /account/balance:
    get:
      description: Get Account Balance
      responses:
        '200':
          description: Get Account Balance response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '401':
          description: Invalid or Expired Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '404':
          description: Balance account not linked
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
components:
  schemas:
    Response:
      type: array
      items:
        type: object
        properties:
          currency:
            type: string
            description: Currency
            enum:
              - TZS
          balance:
            type: number
            description: Account balance
    UnauthorizedError:
      type: object
      properties:
        message:
          type: string
          description: Unauthorized Error
          example: Unauthorized
    NotFoundError:
      type: object
      properties:
        message:
          type: string
          description: Not Found Error
          example: >-
            No balance account is linked to this merchant yet. Balance becomes
            available after the first successful payment or deposit.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authorization header containing the JWT access token returned from the
        generate token endpoint. The token already includes the Bearer prefix.
        Example: `Authorization: Bearer eyJhbGciOi...`
      bearerFormat: JWT

````