Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

REST

Velo

GraphQL (Alpha)

List of app IDs to retrieve plans for.

Min: 1 app ID
Max: 100 app IDs

appIds

Retrieves plans for the given apps.


Also returns tax settings and currency details. Wix calculates this information
based on the 2-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)
format that you pass in the call's header. If you don't pass a country code in
the header, Wix calculates the tax settings and currency details based on the
call's IP address. Note that the tax settings and currency details may not resolve
properly if you call through a VPN.

Prices for plans that are managed outside of Wix aren't returned.

Consumers must pay for yearly and multi-yearly plans of your app every month.
For these plans this endpoint returns the price that the consumer must pay every
month and not the total price for the entire year.

> **Notes:**
> - The App Plans API doesn't follow any tenancy model. You don't need any permissions to call `List App Plans by App ID`.
> - This endpoint only returns app plans that have been activated. ([REST](https://dev.wix.com/docs/rest/app-management/app-billing/app-plans/introduction#before-you-begin)|[SDK](https://dev.wix.com/docs/sdk/backend-modules/app-management/app-plans/introduction)).

import { appPlans } from '@wix/app-management';

async function listAppPlansByAppId(appIds) {
  const response = await appPlans.listAppPlansByAppId(appIds);
};

listAppPlansByAppId: Wix-hosted

import { createClient } from '@wix/sdk';
import { appPlans } from '@wix/app-management';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { appPlans },
  // Include the auth strategy and host as relevant
});


async function listAppPlansByAppId(appIds) {
  const response = await myWixClient.appPlans.listAppPlansByAppId(appIds);
};

Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client).

listAppPlansByAppId: Self-hosted

listAppPlansByAppId

ListAppPlansByAppIdResponse

# About the App Plans API

The App Plans API allows you to get information about all pricing plans that a list of apps offer to users.

With the App Plans API, you can retrieve pricing information for a list of apps.

Learn more about [setting up your app pricing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/about-monetizing-your-app).

## Before you begin

It’s important to note the following points before starting to code:

* You can retrieve pricing information for any app, not just your own. This means your competitors can also retrieve pricing information about your plans, if they have access to your app ID.
* Prices for plans that are managed outside of Wix aren't returned by `listAppPlansByAppId()`.
* `listAppPlansByAppId()` always returns monthly prices. If your app offers yearly plans, Wix calculates and returns the average price per month. For yearly plans, you can get the full price by multiplying the returned price with 12.
* If you want to offer more than 4 plans for your app, you need to create an external pricing page, and you can't use Wix's out-of-the-box pricing page.

## Terminology

* **App plan:** Pricing plan that describes how your app charges users. You can set up multiple plans for your app, with different plans offering different tiers of functionality. For example, you can offer a free plan and 3 paid plans with an increasing number of benefits. Learn more about [setting up your app pricing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/about-monetizing-your-app).
* **Wix pricing page**: Wix offers your app an out-of-the-box pricing page that displays up to 4 app plans for your app to users. Learn more about [setting up a pricing page](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/about-pricing-plans-and-business-models).

@package_metadata:@wix/app-management

To use the AppPlans API, install the `@wix/app-management` package using npm or Yarn:
  ```console
npm install @wix/app-management
```

or

```console
yarn add @wix/app-management
```

Then import `{ appPlans }` from `@wix/app-management`:

```js
import { appPlans } from '@wix/app-management'
```
  

app-management_app-plans

AppPlans

App ID, as defined in the [app dashboard](https://dev.wix.com/apps/my-apps?viewId=active-apps-view).

string

List of the app's pricing plans.

Min: `0` plans
Max: `50` plans

plans

plan billing and charges is managed by the app

plan billing and charges is managed by Wix

BillingSource

Cycle

Duration of the billing cycle. Available only for `{"cycleType": "RECURRING"}`.

cycleDuration

Duration

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.

cycleType

CycleType

Discount

amount

Price without taxes. For yearly plans, Wix calculates and returns the
average price per month. You can get the full price by multiplying the
returned price with 12.
Min: `0.00`
Max: 1024 characters

priceBeforeTax

Total price including taxes.
Min: `0.00`
Max: 1024 characters

totalPrice

type

DiscountType

Discount is a percentage of the total price.

Count of units that make up the billing cycle.

count

number

unit

DurationUnit

Retrieved app plans.

Min: 0 plans
Max: 50 plans

If any plans aren't returned, it's likely because they haven't been activated yet.

appPlans

3-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)
format. Wix calculates the currency based on the country code that
you pass in the call's header. If you don't pass a country code in the header,
Wix calculates the currency based on the caller's IP address. Note that the
currency may not resolve properly if you call through a VPN.

currency

Currency symbol in decimal HTML entity format. For example, `&#36;` for $
(United States Dollar). Wix calculates the currency symbol based on the
country code that you pass in the call's header. If you don't pass a country
code in the header, Wix calculates the tax settings based on the caller's IP
address. Note that the currency symbol may not resolve properly if you call
through a VPN.

currencySymbol

Tax settings. Wix calculates the tax settings based on the country code that
you pass in the call's header. If you don't pass a country code in the header,
Wix calculates the tax settings based on the caller's IP address. Note that the
tax settings may not resolve properly if you call through a VPN.

taxSettings

TaxSettings

Plan

List of your plan's benefits, as defined by you in the [app dashboard](https://dev.wix.com/apps/my-apps?viewId=active-apps-view).
Currently, the benefits are available only in English.

Min: `0` benefits
Max: `4` benefits
Max per benefit: 1024 characters

benefits

Name of your app's pricing plan, as defined by you in the [app dashboard](https://dev.wix.com/apps/my-apps?viewId=active-apps-view).

name

List of the plan's prices. Available only when the plan's prices are managed
by Wix and not externally.

Min: `0` prices
Max: `10` prices

prices

ID of your app's pricing plan, as displayed in the [app dashboard](https://dev.wix.com/apps/my-apps?viewId=active-apps-view).
Identical to `vendorProductId` in the
[Paid Plan Purchased webhook](https://dev.wix.com/docs/rest/api-reference/app-management/apps/app-instance/paid-plan-purchased).

vendorId

Price

Information about the plan's recurring billing cycle or single payment.

billingCycle

billingSource

Can be shown instead of plan price - used for dynamic plans

customPaymentTitle

discount

Price without taxes. For yearly plans, Wix calculates and returns the
average price per month. You can get the full price by multiplying the
returned price by 12.

Min: `0.00`
Max: 1024 characters

Total price including taxes.

Min: `0.00`
Max: 1024 characters

Details about the plan's usage-based pricing.
Available only for plans with
[usage-based pricing](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/usage-based-pricing).

usageBaseOptions

UsageBasedDetails

Tax rate for the given country as percentage. Returned as `0` when
`{"showPriceWithTax": false}`.

percentage

Whether you must display the total price including taxes in the given
country.

showPriceWithTax

boolean

Type of tax required in the given country.

+ `"NOT_APPLICABLE"`: The country doesn't require that you display the total price including taxes, or Wix failed to calculate the country based on the call's IP address.
+ `"VAT"`: The given country requires that you display the total price including [value-added tax (VAT)](https://en.wikipedia.org/wiki/Value-added_tax).
+ `"GST"`: The given country requires that you display the total price including [generation-skipping transfer tax (GST)](https://en.wikipedia.org/wiki/Generation-skipping_transfer_tax).

taxType

TaxType

Description of the usage-based pricing plan, as defined in the [app dashboard](https://dev.wix.com/apps/my-apps?viewId=active-apps-view).

Max: 1024 characters

customChargeDescription

Smallest possible amount that your app charges customers in usage-based
pricing. For example, the price of a single SMS message if your
app charges customers for sending text messages. Always in
[USD](https://en.wikipedia.org/wiki/United_States_dollar).

Min: `0.00`
Max: 1024 characters

minimumChargeIncrement

Recurring, monthly base fee in usage-based pricing that your app
charges customers regardless of how much they use your app.

Min: `0.00`
Max: 1024 characters

listAppPlansByAppId( )