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

# List Account Sandboxes (Admin)

> Returns a list of all accounts and their sandbox usage statistics. Each item includes the account email, total number of sandboxes created, and the timestamp of the most recently created sandbox. Requires the authenticated account to be a Recoup admin. Authentication via x-api-key or Authorization Bearer token.



## OpenAPI

````yaml api-reference/openapi/accounts.json GET /api/admins/sandboxes
openapi: 3.1.0
info:
  title: Recoup API - Accounts
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/admins/sandboxes:
    get:
      description: >-
        Returns a list of all accounts and their sandbox usage statistics. Each
        item includes the account email, total number of sandboxes created, and
        the timestamp of the most recently created sandbox. Requires the
        authenticated account to be a Recoup admin. Authentication via x-api-key
        or Authorization Bearer token.
      parameters: []
      responses:
        '200':
          description: Account sandbox statistics retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminSandboxesResponse'
        '401':
          description: Unauthorized - missing or invalid credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
        '403':
          description: Forbidden - authenticated account is not a Recoup admin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    AdminSandboxesResponse:
      type: object
      required:
        - status
        - accounts
      description: Response containing per-account sandbox statistics for admin use
      properties:
        status:
          type: string
          enum:
            - success
            - error
          description: Status of the request
        accounts:
          type: array
          description: >-
            List of accounts with their sandbox statistics, ordered by most
            recently active first
          items:
            $ref: '#/components/schemas/AccountSandboxRow'
    AccountErrorResponse:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: string
          enum:
            - error
          description: Status of the request
        message:
          type: string
          description: Error message describing what went wrong
    AccountSandboxRow:
      type: object
      required:
        - account_id
        - total_sandboxes
        - last_created_at
      properties:
        account_id:
          type: string
          format: uuid
          description: The unique identifier of the account
          example: 04e3aba9-c130-4fb8-8b92-34e95d43e66b
        total_sandboxes:
          type: integer
          description: Total number of sandboxes created for this account
          example: 5
        last_created_at:
          type: string
          format: date-time
          description: >-
            ISO 8601 timestamp of the most recently created sandbox for this
            account
          example: '2026-03-10T12:00:00Z'
        account_email:
          type: string
          nullable: true
          description: >-
            The email address of the account. Null if the account has no email
            set.
          example: alice@example.com
      description: ''
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Recoup API key. [Learn more](/quickstart#api-keys).
    bearerAuth:
      type: http
      scheme: bearer

````