List Installed Apps on a Site

This recipe guides you through listing all installed apps on a Wix site using the Apps Installer REST API. This is useful for verifying app installations before making API calls that require specific apps.

Prerequisites

• Site ID for the site you want to check

Required APIs

• Apps Installer API: Get Installed Apps

Step 1: Query Installed Apps

Use the Get Installed Apps endpoint to retrieve all apps installed on a site.

Endpoint: GET https://www.wixapis.com/apps-installer-service/v1/app-instances

Request:

Response:

Step 2: Identify Apps by Definition ID

Match the appDefId values from the response against known Wix app IDs.

Common Wix App Definition IDs

For a complete list, see Apps Created by Wix.

Use Cases

Verify App Before API Calls

Before calling APIs that require specific apps (e.g., Bookings, Stores), check if the app is installed:

Diagnose Authorization Errors

If you receive 401 Unauthorized or 403 Forbidden errors from Wix APIs:

1. List installed apps using this recipe
2. Check if the required app is in the response
3. If missing: Install the app using the Install Wix Apps recipe
4. Retry the original API call

Error Handling

401 Unauthorized

• Verify your authentication token is valid
• Check that the token has APP-MARKET.VIEW-INSTALLED-APP permission

Empty Response

• The site may have no additional apps installed beyond core Wix functionality
• This is normal for new or minimal sites

Next Steps

After checking installed apps:

• If app is missing: Use the Install Wix Apps recipe to install required apps
• If app is installed but API fails: Check API permissions and authentication
• For Bookings APIs: See Bookings recipes for service setup