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

# List Accounts

> Lists the authenticated account together with its sub-accounts. The caller's own record always comes first, with a null parent-id. Sub-accounts (every account whose parent is the caller, each carrying the caller's id as its parent-id) are included only for callers with the manage-holders capability; without it, the response contains the caller alone. Requires API access.



## OpenAPI

````yaml GET /api/v1/accounts
openapi: 3.1.0
info:
  title: Crown API & Webhooks
  version: 1.0.0
  description: >-
    Open API 3 docs for Crown API


    Webhook events that Crown will POST to your configured endpoint URL. All
    webhooks expect a 200 OK response. Payloads use kebab-case for all keys to
    match the Crown API conventions.
servers:
  - url: https://app.crown-brlv.com
    description: Production server
security: []
paths:
  /api/v1/accounts:
    get:
      summary: List accounts
      description: >-
        Lists the authenticated account together with its sub-accounts. The
        caller's own record always comes first, with a null parent-id.
        Sub-accounts (every account whose parent is the caller, each carrying
        the caller's id as its parent-id) are included only for callers with the
        manage-holders capability; without it, the response contains the caller
        alone. Requires API access.
      responses:
        '200':
          description: Account and sub-accounts retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  accounts:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Unique identifier of the account
                          example: 019712cf-c86d-703f-85b8-bdaa4fc8d254
                        alias:
                          oneOf:
                            - type: string
                            - type: 'null'
                          description: Human-readable alias for the account
                          example: Trading account
                        status:
                          type: string
                          description: >-
                            Current status of the account. A provisioned account
                            is 'pending-setup' or 'active'. A sub-account still
                            in creation is projected as a pending account
                            carrying its request status: 'pending', 'rejected',
                            or 'provisioning-failed' (see ADR-0008).
                          example: active
                        external-id:
                          oneOf:
                            - type: string
                            - type: 'null'
                          description: External identifier associated with the account
                          example: ext-12345
                        parent-id:
                          oneOf:
                            - type: string
                              format: uuid
                            - type: 'null'
                          description: >-
                            Parent account id when this is a sub-account; null
                            for top-level
                        created-at:
                          type: string
                          example: '2024-01-15T10:30:00Z'
                          format: date-time
                      additionalProperties: false
                      required:
                        - id
                        - alias
                        - status
                        - external-id
                        - created-at
                additionalProperties: false
                required:
                  - accounts
        '400':
          description: Bad request - Invalid input parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Bad request error details
                additionalProperties: false
                required:
                  - error
        '403':
          description: Forbidden - Access denied
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Forbidden access error details
                additionalProperties: false
                required:
                  - error
        '404':
          description: Not found - Resource does not exist
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Resource not found error details
                additionalProperties: false
                required:
                  - error
        '422':
          description: Unprocessable entity - Validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Validation error details
                additionalProperties: false
                required:
                  - error

````