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

# Get billing account

> Returns whether your account is chargeable and ready to pay, with a summary of the default payment method.

Requires the `billing:GetBillingAccount` permission.



## OpenAPI

````yaml /api-reference/openapi/billing.json get /billing/v1/account
openapi: 3.0.3
info:
  title: Mount Thor Billing API
  version: 15089fd70390
  description: >-
    Read your billing account, funds, credits, prices, usage, costs and
    invoices. Amounts are exact: `units` whole currency units plus `nanos`
    billionths, never floating point.
servers:
  - url: https://customer-api.mountthor.com
security:
  - bearerAuth: []
paths:
  /billing/v1/account:
    get:
      summary: Get billing account
      description: >-
        Returns whether your account is chargeable and ready to pay, with a
        summary of the default payment method.


        Requires the `billing:GetBillingAccount` permission.
      operationId: CustomerBillingService_GetBillingAccount
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBillingAccountResponse'
        '400':
          description: The request is invalid, for example an unknown query parameter.
          headers:
            mt-error-slug:
              description: A stable, machine-readable error identifier, when one applies.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            The credential is missing, invalid or expired. The response has no
            body.
          headers:
            mt-error-slug:
              description: A stable, machine-readable error identifier, when one applies.
              schema:
                type: string
        '403':
          description: >-
            The credential does not allow this operation. When a permission is
            missing, `requiredAction` names it; otherwise the body may be empty.
          headers:
            mt-error-slug:
              description: A stable, machine-readable error identifier, when one applies.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    GetBillingAccountResponse:
      type: object
      properties:
        customer_id:
          type: string
          description: Your account ID.
        billing_mode:
          type: string
          description: '`chargeable`, or `comped` for an account that is not charged.'
        payment_method_ready:
          type: boolean
          description: >-
            Whether a default payment method is on file for automatic
            collection.
        billing_address_ready:
          type: boolean
          description: Whether your billing address is complete.
        default_payment_method:
          allOf:
            - $ref: '#/components/schemas/PaymentMethodSummary'
          description: A summary of your default payment method, when one is on file.
    Error:
      type: object
      properties:
        code:
          type: integer
          description: A numeric status code.
        message:
          type: string
          description: A human-readable explanation.
        reason:
          type: string
          description: On a 403 from a missing permission, `permission_denied`.
        requiredAction:
          type: string
          description: >-
            On a 403 from a missing permission, the permission the request
            needs.
    PaymentMethodSummary:
      type: object
      properties:
        payment_method_type:
          type: string
          description: e.g. "card".
        brand:
          type: string
          description: e.g. "visa" (empty when unknown).
        last4:
          type: string
          description: Last four digits (empty when unknown).
        expiry_month:
          type: integer
          description: 1-12; 0 when unknown.
          format: int32
        expiry_year:
          type: integer
          description: Four-digit year; 0 when unknown.
          format: int32
      description: >-
        Display details of your default payment method. Card numbers are never
        returned.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Send `Authorization: Bearer <credential>` to
        https://customer-api.mountthor.com. People use the session that `mthr
        login` stores (a token starting `mt_session_`, valid for up to 12
        hours). Automation uses a service-account credential (starting
        `mt_sa_v1_`, valid for 90 days) from Create credential. Each operation
        names the permission it needs. Service accounts hold permissions through
        custom roles, and some operations refuse them; those operations say so.

````

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