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

# Get your agent's daily spend cap

> Your personal agent's daily spend cap and what its model calls have settled today, in your timezone. The cap bounds every model call the agent makes, whatever started it.



## OpenAPI

````yaml api-reference/openapi.account.json GET /agent/daily-cap
openapi: 3.1.0
info:
  title: Aether Account & Integrations API
  version: 0.1.0
  description: >-
    Account, billing, and integration-management endpoints used by the Aether
    web app and CLI. Root-mounted; NOT part of the versioned /v1 contract.
servers:
  - url: https://api.runaether.dev
security:
  - bearerAuth: []
paths:
  /agent/daily-cap:
    get:
      tags:
        - agent
      summary: Get your agent's daily spend cap
      description: >-
        Your personal agent's daily spend cap and what its model calls have
        settled today, in your timezone. The cap bounds every model call the
        agent makes, whatever started it.
      operationId: getAgentDailyCap
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDailyCap'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrgAuthorizationErrorResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal Server Error
components:
  schemas:
    AgentDailyCap:
      additionalProperties: false
      properties:
        daily_cap_cents:
          description: >-
            The most the agent may spend on inference in a day, over every model
            call it makes, in US cents. A model call is refused (402
            agent_host_daily_cap_reached) once the day's settled spend plus what
            the agent's calls in flight hold reaches it, until midnight in the
            timezone, until calls in flight settle under it, or until the cap is
            raised past them.
          format: int32
          type: integer
        day:
          description: >-
            Today in the agent's timezone, as YYYY-MM-DD: the day
            spent_microdollars is for.
          pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
          type: string
        spent_microdollars:
          description: >-
            What the agent's model calls settled today, in millionths of a US
            dollar.
          format: int64
          type: integer
        timezone:
          description: The owner's IANA timezone, whose midnight starts the next day.
          type: string
      required:
        - daily_cap_cents
        - day
        - timezone
        - spent_microdollars
      type: object
    ErrorResponse:
      additionalProperties: false
      properties:
        code:
          type: string
        error:
          minLength: 1
          type: string
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
      required:
        - error
      type: object
    OrgAuthorizationErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - org_membership_required
            - org_role_insufficient
            - org_suspended
            - account_deleting
          type: string
        error:
          minLength: 1
          type: string
      required:
        - error
        - code
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````

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