App monetization utilizes subscriptions as a billing contract between a user and an app. Each subscription contains unique data about the user's billing frequency, plan type, and renewal period.

Queries

Get app subscriptions

Only works for app collaborators
Limit: 120 times per minute
Returns an array containing data about all of your app's subscriptions
Can only be queried directly at the root; can't be nested within another query

🚧
If you only want to query a specific account's subscription from the context of your app, use the app_subscription object instead.

query {
  app_subscriptions(app_id: 1234567890) {
    cursor
    total_count 
    subscriptions {
      account_id
      monthly_price
      currency
      max_units
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = "query($appId:ID!) { app_subscriptions (app_id: $appId) { cursor total_count subscriptions { account_id monthly_price currency } } }";
const variables = {
  appId: 123456789,
};
const response = await mondayApiClient.request(query, variables);

Arguments

Fields	Type	Description	Enum Values
account_id	`Int`	The account's unique identifier.
app_id	`ID!`	The app's unique identifier.
cursor	`String`	An opaque token representing the position in a set of results to fetch subscriptions from. Use this to paginate through large result sets.
limit	`Int`	The number of subscriptions to return. The default is 100, but the maximum is 500.
status	`SubscriptionStatus`	The subscription's status.	`active` `inactive`

Fields

Fields	Type	Description
cursor	`String`	An opaque cursor that represents the position in the list after the last returned subscription. Use this cursor for pagination to fetch the next set of subscriptions. If the cursor is null, there are no more subscriptions to fetch.
subscriptions	`[AppSubscriptionDetails!]!`	Further details about the app's subscriptions.
total_count	`Int!`	The total number of subscriptions.