Setting the file. One moment.
Subchapter 8.5
references/app-installation/list-installed-apps.mdMarkdown4 KBView on GitHub
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.
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"
}
]
}Match the appDefId values from the response against known Wix app IDs.
| App | appDefId |
|---|---|
| Wix Stores | 1380b703-ce81-ff05-f115-39571d94dfcd |
| Wix Bookings | 13d21c63-b5ec-5912-8397-c3a5ddb27a97 |
| Wix Blog | 14bcded7-0066-7c35-14d7-466cb3f09103 |
| Wix Events | 140603ad-af8d-84a5-2c80-a0f60cb47351 |
| Wix Pricing Plans | 1522827f-c56c-a5c9-2ac9-00f9e6ae12d3 |
| Wix Restaurants | 13e8d036-5516-6f75-e025-2aca3b5d7930 |
For a complete list, see Apps Created by Wix (opens in a new tab).
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
}If you receive 401 Unauthorized or 403 Forbidden errors from Wix APIs:
APP-MARKET.VIEW-INSTALLED-APP permissionAfter checking installed apps: