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

# List Teammates



## OpenAPI

````yaml /api-reference/customer-api.v1.openapi.json get /v1/admin/customer-users
openapi: 3.1.0
info:
  title: Mount Thor Customer API
  version: v1
servers:
  - description: Mount Thor customer API edge
    url: https://api.mountthor.com
security: []
paths:
  /v1/admin/customer-users:
    get:
      tags:
        - customer-users
      summary: List Teammates
      operationId: list_customer_users
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerUserListResponse'
          description: Customer users for this account
        '401':
          description: Missing or invalid customer credential
        '403':
          description: Credential is missing users:read scope
        '429':
          content:
            text/plain:
              schema:
                type: string
          description: Rate limit exceeded
          headers:
            Retry-After:
              description: Seconds before retry.
              schema:
                minimum: 1
                type: integer
      security:
        - api_key_bearer:
            - users:read
components:
  schemas:
    CustomerUserListResponse:
      additionalProperties: false
      properties:
        customer_id:
          description: Stable UUID for the customer account.
          format: uuid
          type: string
        customer_users:
          description: |-
            Customer users visible to the caller. Ordered by status
            (active first, then invited, then revoked, then suspended,
            then anything else) and within a status by `created_at`
            ascending so the long-running members stay above newer rows.
          items:
            $ref: '#/components/schemas/CustomerUserMetadata'
          type: array
      required:
        - customer_id
        - customer_users
      type: object
    CustomerUserMetadata:
      additionalProperties: false
      properties:
        access_role:
          example: customer-admin
          type:
            - string
            - 'null'
        billing_owner:
          description: >-
            Whether this user is a `billing-owner` for the customer — i.e. an

            active `people` row with `role_type='billing-owner'` whose email

            matches this user's (case-insensitive). Billing-owners can manage

            payment/funding surfaces and grant billing-capable keys;
            organization

            Administrators may read billing summaries without this independent

            role.
          example: 'true'
          type: boolean
        created_at:
          description: RFC 3339 creation timestamp.
          example: '2026-05-25T17:30:00Z'
          type: string
        customer_user_id:
          description: Stable UUID for the customer user row.
          format: uuid
          type: string
        display_name:
          example: Alice Example
          type:
            - string
            - 'null'
        email:
          description: Lowercased email used as the identity binding key for this user.
          example: alice@acmecorp.com
          type: string
        status:
          example: active
          type: string
        updated_at:
          description: RFC 3339 last-update timestamp.
          example: '2026-06-01T15:00:00Z'
          type: string
        user_type:
          example: human
          type: string
      required:
        - customer_user_id
        - email
        - status
        - user_type
        - billing_owner
        - created_at
        - updated_at
      type: object
  securitySchemes:
    api_key_bearer:
      bearerFormat: mthr_live_*
      description: Bearer scheme name used by typed customer admin operations.
      scheme: bearer
      type: http

````