> ## 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.

# List Member Budgets

> Read every organization member's monthly budget and spend at /api/v1/org/members/budgets

## Overview

Lists every member of your organization with their monthly budget (`monthlyLimit`, `null` when unset), their spend this UTC month (`spent`), and whether they are `paused`. Use the `userId` values to [set a member budget](https://docs.morphllm.com/api-reference/endpoint/org-member-budget-set.md).

Call it with an organization API key owned by an organization admin. Personal keys and member keys get `403`.

Spend is the member's usage on the organization's keys at your organization's prices, whether credits or the card pays for it. It updates about every 30 minutes.


## OpenAPI

````yaml GET /api/v1/org/members/budgets
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, 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: organization
    description: Organization member budgets.
  - name: telemetry
    description: Usage reporting hooks.
paths:
  /api/v1/org/members/budgets:
    get:
      tags:
        - organization
      summary: List member budgets
      description: >-
        Lists every member of the key’s organization with their monthly budget
        and spend this UTC month. Requires an organization API key owned by an
        organization admin.
      operationId: listMemberBudgets
      responses:
        '200':
          description: Every member with their budget.
          content:
            application/json:
              example:
                month: 2026-11
                members:
                  - userId: user_2xKq8T1fJ3mZ5bR9cW7vN4pL6hD
                    monthlyLimit: '50.00'
                    spent: '12.34'
                    paused: false
                    email: dev@example.com
                    role: member
              schema:
                $ref: '#/components/schemas/MemberBudgetList'
        '401':
          $ref: '#/components/responses/OrgUnauthorized'
        '403':
          $ref: '#/components/responses/OrgForbidden'
      security:
        - bearerAuth: []
components:
  schemas:
    MemberBudgetList:
      type: object
      properties:
        month:
          type: string
          description: The UTC month spend covers, YYYY-MM.
          example: 2026-11
        members:
          type: array
          items:
            $ref: '#/components/schemas/OrgMemberBudget'
          description: Every organization member.
          example:
            - userId: user_2xKq8T1fJ3mZ5bR9cW7vN4pL6hD
              monthlyLimit: '50.00'
              spent: '12.34'
              paused: false
              email: dev@example.com
              role: member
      required:
        - month
        - members
      description: The organization’s members and the month their spend covers.
      example:
        month: 2026-11
        members:
          - userId: user_2xKq8T1fJ3mZ5bR9cW7vN4pL6hD
            monthlyLimit: '50.00'
            spent: '12.34'
            paused: false
            email: dev@example.com
            role: member
    OrgMemberBudget:
      allOf:
        - $ref: '#/components/schemas/MemberBudget'
        - type: object
          properties:
            email:
              type: string
              description: The member’s email address.
              example: dev@example.com
            role:
              type: string
              enum:
                - admin
                - member
              description: The member’s organization role.
              example: member
          required:
            - email
            - role
      description: One organization member with their budget.
      example:
        userId: user_2xKq8T1fJ3mZ5bR9cW7vN4pL6hD
        monthlyLimit: '50.00'
        spent: '12.34'
        paused: false
        email: dev@example.com
        role: member
    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
    MemberBudget:
      type: object
      properties:
        userId:
          type: string
          description: The member’s user id.
          example: user_2xKq8T1fJ3mZ5bR9cW7vN4pL6hD
        monthlyLimit:
          type:
            - string
            - 'null'
          description: >-
            Monthly budget in USD, two decimals. Null when the member has no
            budget.
          example: '50.00'
        spent:
          type: string
          description: >-
            The member’s spend on the organization’s keys this UTC month, in USD
            at the organization’s prices. Updated about every 30 minutes.
          example: '12.34'
        paused:
          type: boolean
          description: >-
            True once spend reached the budget. The member’s organization keys
            get `429 member_budget_exceeded` until the budget is raised or
            removed, or the next UTC month starts.
          example: false
      required:
        - userId
        - monthlyLimit
        - spent
        - paused
      description: A member’s monthly budget and spend.
      example:
        userId: user_2xKq8T1fJ3mZ5bR9cW7vN4pL6hD
        monthlyLimit: '50.00'
        spent: '12.34'
        paused: false
  responses:
    OrgUnauthorized:
      description: Missing or invalid Morph API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/OrgError'
          example:
            error: Unauthorized
    OrgForbidden:
      description: >-
        The key is a personal key, or belongs to an organization member who is
        not an admin.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/OrgError'
          example:
            error: Only an organization admin can manage member budgets
  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.