/wix-manage

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:

curl -X GET \
  'https://www.wixapis.com/apps-installer-service/v1/app-instances' \
  -H 'Authorization: <AUTH>' \
  -H 'Content-Type: application/json'

Response:

{
  "appInstances": [
    {
      "id": "instance-id-1",
      "appDefId": "1380b703-ce81-ff05-f115-39571d94dfcd",
      "version": "^0.0.0",
      "enabled": true,
      "status": "UNKNOWN"
    },
    {
      "id": "instance-id-2",
      "appDefId": "13d21c63-b5ec-5912-8397-c3a5ddb27a97",
      "enabled": true,
      "status": "UNKNOWN"
    }
  ]
}

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:

// Pseudocode example
const installedApps = await getInstalledApps(siteId);
const bookingsAppId = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";

const hasBookings = installedApps.appInstances.some(
  app => app.appDefId === bookingsAppId
);

if (!hasBookings) {
  // Install Bookings app first
  // See: Install Wix Apps recipe
}

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