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

# Get Account Settings

> Read your billing settings at /api/v1/account/settings

## Overview

Returns the settings on the [billing page](https://www.morphllm.com/dashboard/billing): extra usage, the monthly spend limit, the spend alert and auto-reload. An organization key returns the organization's settings and needs an organization admin; a personal key returns its owner's.

```bash theme={null}
curl https://api.morphllm.com/api/v1/account/settings \
  -H "Authorization: Bearer $MORPH_API_KEY"
```

From the CLI: `morph settings`.


## OpenAPI

````yaml GET /api/v1/account/settings
openapi: 3.1.0
info:
  title: Morph API
  version: 1.2.0
  description: >-
    The Morph public API at api.morphllm.com: OpenAI- and Anthropic-compatible
    inference (chat completions, messages), Fast Apply code editing, Compact
    context compression, System One typed decisions, model listing, and
    dedicated endpoint management, agentic credit top-ups paid over x402,
    account billing settings, and organization member budgets. Model ids,
    prices, and context windows are served live at
    https://www.morphllm.com/api/models/json.
  contact:
    name: Morph
    url: https://morphllm.com
    email: info@morphllm.com
  license:
    name: Proprietary
    url: https://morphllm.com/privacy/tos
servers:
  - url: https://api.morphllm.com
    description: Production
security: []
tags:
  - name: chat
    description: >-
      OpenAI- and Anthropic-compatible chat inference, including Fast Apply and
      WarpGrep models.
  - name: compact
    description: Context compression for long agent conversations.
  - name: systemone
    description: 'Typed decisions: a state in, a probability distribution per question out.'
  - name: models
    description: Model listing.
  - name: dedicated
    description: Dedicated endpoint discovery, status, and cancellation.
  - name: credits
    description: Agentic credit top-ups paid in USDC over x402.
  - name: account
    description: 'Billing settings: extra usage, spend limit and alert, auto-reload.'
  - name: organization
    description: Organization member budgets.
  - name: telemetry
    description: Usage reporting hooks.
paths:
  /api/v1/account/settings:
    get:
      tags:
        - account
      summary: Get account settings
      description: >-
        Returns the billing settings of the key’s account: its organization for
        an organization key (organization admins only), or its owner for a
        personal key.
      operationId: getAccountSettings
      responses:
        '200':
          description: The account’s settings.
          content:
            application/json:
              example:
                account: personal
                plan: UNLIMITED
                extraUsage: false
                monthlySpendLimit: '50.00'
                spendAlert: null
                autoReload: false
                autoReloadThreshold: '5.00'
                autoReloadAmount: '40.00'
              schema:
                $ref: '#/components/schemas/AccountSettings'
        '401':
          $ref: '#/components/responses/OrgUnauthorized'
        '403':
          $ref: '#/components/responses/AccountForbidden'
      security:
        - bearerAuth: []
components:
  schemas:
    AccountSettings:
      type: object
      properties:
        account:
          type: string
          enum:
            - personal
            - organization
          description: >-
            Whose settings these are: the key owner’s personal account, or the
            key’s organization.
          example: personal
        plan:
          type: string
          description: >-
            The account’s plan tier, e.g. UNLIMITED (Ultra), SCALE, USAGE (pay
            as you go), FREE.
          example: UNLIMITED
        extraUsage:
          type: boolean
          description: >-
            Whether usage past the account’s credits bills to its card. On Ultra
            this covers models outside the plan: off, they return 402 once
            credits run out while Ultra’s models keep serving.
          example: false
        monthlySpendLimit:
          type:
            - string
            - 'null'
          description: >-
            Monthly cap in USD on what extra usage bills to the card. Null when
            there is no limit.
          example: '50.00'
        spendAlert:
          type:
            - string
            - 'null'
          description: Monthly spend in USD that triggers an email alert. Null when off.
          example: '100.00'
        autoReload:
          type: boolean
          description: Whether credits top up automatically from the card on file.
          example: false
        autoReloadThreshold:
          type: string
          description: Auto-reload buys credits when the balance falls below this, in USD.
          example: '5.00'
        autoReloadAmount:
          type: string
          description: USD of credits each auto-reload buys.
          example: '40.00'
      required:
        - account
        - plan
        - extraUsage
        - monthlySpendLimit
        - spendAlert
        - autoReload
        - autoReloadThreshold
        - autoReloadAmount
      description: The account’s billing settings.
      example:
        account: personal
        plan: UNLIMITED
        extraUsage: false
        monthlySpendLimit: '50.00'
        spendAlert: null
        autoReload: false
        autoReloadThreshold: '5.00'
        autoReloadAmount: '40.00'
    OrgError:
      type: object
      properties:
        error:
          type: string
          description: Why the request failed.
          example: Member not found
      required:
        - error
      description: Error body returned by the organization routes.
      example:
        error: Member not found
  responses:
    OrgUnauthorized:
      description: Missing or invalid Morph API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/OrgError'
          example:
            error: Unauthorized
    AccountForbidden:
      description: An organization key whose owner is not an organization admin.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/OrgError'
          example:
            error: Only an organization admin can manage billing settings
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: >-
        Morph API key, passed as `Authorization: Bearer sk-...`. Create keys at
        https://www.morphllm.com/dashboard/api-keys.

````

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