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

# Get Balance

> Get your AI telephony account balance and rate card.

Returns the current balance and currency. Calls are 0.10 USD per minute in both directions. A 0-second call is free. A connected call has a one-minute minimum, then the actual duration rounded up to the cent. Phone numbers are 2.00 USD per month. The rate card also includes inbound SMS.
Use this to check affordability before paid telephony operations.



## OpenAPI

````yaml /openapi.json get /v1/billing/balance
openapi: 3.1.0
info:
  title: AgentLine
  description: >-
    AgentLine gives every AI agent a real US phone number and a human-like
    voice. Agents can make and receive calls and receive SMS. This spec covers
    the core developer surface: agents, numbers, calls, messages, events,
    webhooks, billing, and voice.
  version: 0.3.0
  summary: US phone numbers and voice for AI agents. Inbound SMS can be read.
  contact:
    name: AgentLine
    url: https://agentline.cloud
  license:
    name: MIT
    url: https://opensource.org/license/mit
servers:
  - url: https://api.agentline.cloud
    description: Production
security:
  - API Key or OAuth: []
paths:
  /v1/billing/balance:
    get:
      tags:
        - Billing
      summary: Get Balance
      description: >-
        Get your AI telephony account balance and rate card.


        Returns the current balance and currency. Calls are 0.10 USD per minute
        in both directions. A 0-second call is free. A connected call has a
        one-minute minimum, then the actual duration rounded up to the cent.
        Phone numbers are 2.00 USD per month. The rate card also includes
        inbound SMS.

        Use this to check affordability before paid telephony operations.
      operationId: get_account_balance
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
        - API Key or OAuth: []
components:
  securitySchemes:
    API Key or OAuth:
      type: http
      description: >-
        AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp
        then POST /v1/auth/verify). Pass as: Authorization: Bearer al_live_...
        (legacy sk_live_... still works).
      scheme: bearer
      bearerFormat: API key (al_live_...)
      x-fern-bearer:
        name: apiKey
        env: AGENTLINE_API_KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.