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

# List Marketplace Apps

> Lists the apps approved in the marketplace, by name, each with whether it's on for the viewer and for their org, and the scopes the viewer may turn apps on and off for.

Takes the marketplace owner's user JWT for the viewer, with `embed:enable` in its `rollout.com` scopes, expiring within an hour.



## OpenAPI

````yaml /openapi/rollout.json get /embedded-apps/marketplaces/{marketplaceId}/apps
openapi: 3.1.2
info:
  title: Universal API Documentation
  description: Development documentation
  version: '1.0'
servers:
  - url: https://universal.rollout.com/api
security: []
paths:
  /embedded-apps/marketplaces/{marketplaceId}/apps:
    get:
      tags:
        - Embedded Apps
      summary: List Marketplace Apps
      description: >-
        Lists the apps approved in the marketplace, by name, each with whether
        it's on for the viewer and for their org, and the scopes the viewer may
        turn apps on and off for.


        Takes the marketplace owner's user JWT for the viewer, with
        `embed:enable` in its `rollout.com` scopes, expiring within an hour.
      operationId: getEmbedded-appsMarketplacesByMarketplaceIdApps
      parameters:
        - name: marketplaceId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            description: The marketplace's id.
        - name: appId
          in: query
          required: false
          schema:
            description: Lists this app only, e.g. for your own page about it.
            type: string
            minLength: 1
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                properties:
                  canEnable:
                    type: array
                    items:
                      type: string
                      enum:
                        - user
                        - org
                      description: >-
                        Who an enablement turns an app on for: `user`, the
                        viewer alone, or `org`, everyone in the viewer's org.
                    description: >-
                      The scopes the viewer may turn apps on for: those the
                      marketplace allows that the token grants. `org` needs
                      `embed:enable_org` and `embed.org`.
                  canDisable:
                    type: array
                    items:
                      type: string
                      enum:
                        - user
                        - org
                      description: >-
                        Who an enablement turns an app on for: `user`, the
                        viewer alone, or `org`, everyone in the viewer's org.
                    description: >-
                      The scopes the viewer may turn apps off for: those the
                      token grants, whatever the marketplace allows. One missing
                      from `canEnable` is a scope the marketplace stopped
                      allowing, whose apps stay on until turned off.
                  apps:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        tagline:
                          type: string
                        description:
                          type: string
                        iconUrl:
                          description: >-
                            The app's icon on Rollout's origin, a PNG, JPEG or
                            WebP image, or null.
                          type:
                            - string
                            - 'null'
                        supportUrl:
                          description: An http(s) URL, or null.
                          type:
                            - string
                            - 'null'
                        privacyPolicyUrl:
                          description: An http(s) URL, or null.
                          type:
                            - string
                            - 'null'
                        enabled:
                          type: object
                          properties:
                            user:
                              type: boolean
                              description: Whether the viewer turned it on for themselves.
                            org:
                              type: boolean
                              description: >-
                                Whether the viewer's org has it on; false for a
                                token without `embed.org`.
                          required:
                            - user
                            - org
                      required:
                        - id
                        - name
                        - tagline
                        - description
                        - iconUrl
                        - supportUrl
                        - privacyPolicyUrl
                        - enabled
                required:
                  - canEnable
                  - canDisable
                  - apps
        '401':
          description: Response for status 401
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                        - code
                        - message
                required:
                  - errors
        '403':
          description: Response for status 403
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                        - code
                        - message
                required:
                  - errors
        '404':
          description: Response for status 404
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                        - code
                        - message
                required:
                  - errors
      security:
        - jwt: []
components:
  securitySchemes:
    jwt:
      type: http
      scheme: bearer
      description: Consumer JWT minted by the tenant's backend

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.