> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: App Installations

# Type: App Installation Object

# Link: https://dev.wix.com/docs/api-reference/app-management/app-installations/app-installation-object.md

## Description: An app installation represents a single installation of one of your apps on a Wix site. It includes details about the site, the app instance, the installed app version, the purchased plan, the installation status, and any review the site owner left for the app.

## Schema:

```json
 Type: App Installation Object | type: AppInstallation
 Description: An app installation represents a single installation of one of your apps on a Wix site. It includes details about the site, the app instance, the installed app version, the purchased plan, the installation status, and any review the site owner left for the app.
       - name: id  | type: string | description: App installation ID.
           - name: value  | type: string | description: 
       - name: instanceId  | type: string | description: Unique identifier of the app instance on the site. Stable across uninstalls and reinstalls of the same app on the same site.
       - name: createdDate  | type: string | description: Date and time the app installation was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the app installation was last updated.
       - name: revision  | type: string | description: Revision number, which increments by 1 each time the app installation is updated.
           - name: value  | type: string | description: 
       - name: firstInstallationDate  | type: string | description: Date and time the app was first installed on the site. Preserved across uninstalls and reinstalls.
       - name: siteInfo  | type: SiteInfo | description: Information about the site the app is installed on.
           - name: siteId  | type: string | description: Site ID.
           - name: businessName  | type: string | description: Business name displayed on the site.
           - name: siteUrl  | type: string | description: Public URL of the site.
           - name: businessEmail  | type: string | description: Business email address configured on the site.
           - name: countryCode  | type: string | description: 2-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
           - name: businessCategory  | type: Categories | description: Business category the site belongs to.
               - name: primary  | type: string | description: Primary site category.
               - name: secondary  | type: Array<string> | description: Secondary site category.
           - name: premium  | type: boolean | description: Whether the site has an active Premium subscription.
           - name: editorType  | type: string | description: Editor the site was created with.
               enum: EDITOR, ADI, EDITORX, STUDIO, HARMONY, VIBE, WIXEL
           - name: ownerEmail  | type: string | description: Email address of the site owner. Returned only when `OWNER_EMAIL` is requested in the `fields` parameter and the app has the **Get Site Owner** permission.
           - name: accountId  | type: string | description: ID of the site owner's account.
       - name: planInfo  | type: PlanInfo | description: Information about the plan the site owner purchased for the app.
           - name: planName  | type: string | description: Name of the plan the site owner purchased for the app.
           - name: billingCycle  | type: Cycle | description: Billing cycle of the purchased plan.
               - name: cycleType  | type: string | description: Type of the billing cycle.  + `"UNKNOWN_UNIT"`:  There is no information about the billing cycle. + `"ONE_TIME"`:  The customer pays for unlimited usage of the app with a single payment. + `"RECURRING"`: The customer pays for a subscription to the app on a recurring schedule.
               - name: cycleDuration  | type: Duration | description: Duration of the billing cycle. Available only for `{"cycleType": "RECURRING"}`.
           - name: planStatus  | type: string | description: Current status of the purchased plan.
               enum: UPGRADED, CANCELED, AUTO_RENEW_OFF
           - name: freeTrialInfo  | type: FreeTrialInfo | description: Free trial details for the purchased plan, if a free trial is or was active.
               - name: status  | type: string | description: Current free trial status.
               - name: endDate  | type: string | description: Date and time the free trial ended.  Returned only after the free trial has ended.
           - name: endDate  | type: string | description: Date and time the plan expires.  Returned only when auto-renewal is turned off.
       - name: appId  | type: string | description: ID of the installed app.
       - name: appVersion  | type: string | description: Major version of the installed app.
       - name: status  | type: string | description: Current installation status of the app on the site.
           enum: INSTALLED, UNINSTALLED
       - name: review  | type: ReviewInfo | description: Information about the review the site owner left for the app, if any.
           - name: id  | type: string | description: Review ID.
           - name: date  | type: string | description: Date and time the review was published.
           - name: rating  | type: number | description: Rating the site owner left for the app, from 1 to 5.
               - name: value  | type: number | description: 
           - name: title  | type: string | description: Review title.
           - name: description  | type: string | description: Review body text.

```