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

# List App Versions

> Returns a list of all app versions for a given package name



## OpenAPI

````yaml Get /v1/apps/{packageName}/versions
openapi: 3.1.0
info:
  title: ManageXR API
  description: API documentation for ManageXR
  version: 1.0.0
servers:
  - url: https://managexrapi.com
    description: ManageXR API Server
security:
  - basicAuth: []
paths:
  /v1/apps/{packageName}/versions:
    get:
      summary: List app versions
      description: Returns a list of all app versions for a given package name
      parameters:
        - name: packageName
          in: path
          required: true
          schema:
            type: string
          description: The package name of the app
        - name: organizationId
          in: query
          required: false
          schema:
            type: string
          description: >
            Unique identifier of the organization. This parameter is only
            necessary when using multi-organization API keys. 


            Defaults to the organizationId associated with the API key.
      responses:
        '200':
          description: A list of app versions
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier of the app version
                          example: av_123
                        type:
                          type: string
                          enum:
                            - managed
                            - shared
                            - external
                            - instant
                          description: Type of the app version
                          example: managed
                        configurationDeployments:
                          type: object
                          description: >-
                            Map of configuration ids to device count using
                            application
                          example:
                            config_123: 1
                            config_456: 0
                        createdAt:
                          type: number
                          description: Creation timestamp
                          example: 1645615777448
                        updatedAt:
                          type: number
                          description: Last update timestamp
                          example: 1687352117203
                        versionCode:
                          type: number
                          description: Version code of the app
                          example: 83894522
                        versionName:
                          type: string
                          description: Version name of the app
                          example: 8.7.8.1206
                        versionLabel:
                          type: string
                          description: Label for uniqueness among app versions
                          example: Quest
                        apkSize:
                          type: number
                          description: Size of the APK file in bytes
                          example: 72633861
                        obbSize:
                          type: number
                          description: Size of the OBB file in bytes
                          example: 1024
                        selfHosted:
                          type: boolean
                          description: Whether the app is self-hosted
                          example: true
                        apkUrl:
                          type: string
                          description: URL of the APK file (self-hosted apps only)
                          example: https://storage.example.com/apps/com.example.app.apk
                        obbUrl:
                          type: string
                          description: URL of the OBB file (self-hosted apps only)
                          example: https://storage.example.com/apps/com.example.app.obb
                        sharingOrganizationName:
                          type: string
                          description: >-
                            Name of the organization sharing the app (shared
                            apps only)
                          example: XR Developer
                        releaseChannelName:
                          type: string
                          description: Name of the release channel (shared apps only)
                          example: Production
                        supportedDeviceModels:
                          type: array
                          items:
                            type: string
                            example: Quest 3
                          description: >-
                            List of supported device models for Instant App
                            (instant apps only)
                          example:
                            - Quest 3
                            - Quest 3S
                            - Pico 4 Ultra Enterprise
              example:
                data:
                  - id: av_123
                    type: managed
                    configurationDeployments:
                      config_123: 1
                      config_456: 0
                    createdAt: 1645615777448
                    updatedAt: 1687352117203
                    versionCode: 83894522
                    versionName: 8.7.8.1206
                    versionLabel: Quest
                    apkSize: 72633861
                    obbSize: 1024
                    selfHosted: true
                    apkUrl: https://storage.example.com/apps/com.example.app.apk
                    obbUrl: https://storage.example.com/apps/com.example.app.obb
                  - id: av_456
                    type: shared
                    configurationDeployments:
                      config_123: 0
                      config_456: 1
                    createdAt: 1645615777448
                    updatedAt: 1687352117203
                    versionCode: 83894522
                    versionName: 8.7.8.1206
                    versionLabel: Quest
                    apkSize: 72633861
                    obbSize: 1024
                    selfHosted: false
                    releaseChannelName: Production
                    sharingOrganizationName: XR Developer
        '404':
          description: App not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 404
                  message:
                    type: string
                    example: App with package name com.example.app not found
                  error:
                    type: string
                    example: ManageXR Error
              example:
                statusCode: 404
                message: App with package name com.example.app not found
                error: ManageXR Error
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >
        API key based authentication where <encoded-value> is the Base64
        encoding of `API_KEY_ID`:`API_KEY_SECRET`

        - **Username**: The API Key ID.

        - **Password**: The API Key Secret.

````