Help improve docs quality by sharing anonymous interaction telemetry (no PII or token data).

GraphQL Explorer

Browse the complete GraphQL schema and run operations against the interactive explorer.

GraphQL endpoint

https://app.monetizekit.app/api/graphql

Schema

OBJECT Query

FieldTypeArgumentsComplexityDescriptionDeprecated
planPlankey: String! (required)4Get one plan with entitlementsNo
customers[Customer]first: Int, after: String6List customersNo
entitlementCheckEntitlementDecisioncustomerId: ID! (required), featureKey: String! (required)3Check one entitlement decisionNo
usageCounterUsageCountercustomerId: ID! (required), meterKey: String! (required)3Fetch usage counterNo
creditBalanceCreditBalancecustomerId: ID! (required)3Fetch customer creditsNo

OBJECT Mutation

FieldTypeArgumentsComplexityDescriptionDeprecated
createCustomerCustomerinput: CreateCustomerInput! (required)5Create a customerNo
submitUsageUsageEventResultinput: UsageEventInput! (required)5Submit usage eventNo

OBJECT Subscription

FieldTypeArgumentsComplexityDescriptionDeprecated
usageUpdatedUsageCountercustomerId: ID! (required)2Usage stream updatesNo

OBJECT Customer

FieldTypeArgumentsComplexityDescriptionDeprecated
idID!None1—No
externalIdString!None1—No
statusString!None1—No
subscriptions[SubscriptionPlan]None2—No

OBJECT Plan

FieldTypeArgumentsComplexityDescriptionDeprecated
idID!None1—No
keyString!None1—No
nameString!None1—No
entitlements[Entitlement]None3—No
legacyFlags[String]None2—Use entitlements instead of legacyFlags; removal v2.4

OBJECT Entitlement

FieldTypeArgumentsComplexityDescriptionDeprecated
featureKeyString!None1—No
valueString!None1—No

OBJECT EntitlementDecision

FieldTypeArgumentsComplexityDescriptionDeprecated
allowedBoolean!None1—No
reasonString!None1—No

OBJECT UsageCounter

FieldTypeArgumentsComplexityDescriptionDeprecated
meterKeyString!None1—No
currentInt!None1—No
limitIntNone1—No

OBJECT CreditBalance

FieldTypeArgumentsComplexityDescriptionDeprecated
availableInt!None1—No
pendingInt!None1—No

OBJECT SubscriptionPlan

FieldTypeArgumentsComplexityDescriptionDeprecated
idID!None1—No
planKeyString!None1—No

OBJECT UsageEventResult

FieldTypeArgumentsComplexityDescriptionDeprecated
acceptedBoolean!None1—No
eventIdID!None1—No

INPUT_OBJECT CreateCustomerInput

Input fieldTypeRequiredDescription
externalIdString!yes—
nameStringno—

INPUT_OBJECT UsageEventInput

Input fieldTypeRequiredDescription
customerIdID!yes—
meterKeyString!yes—
valueInt!yes—

OBJECT Webhook

FieldTypeArgumentsComplexityDescriptionDeprecated
idID!None1—No
urlString!None1—No

OBJECT Meter

FieldTypeArgumentsComplexityDescriptionDeprecated
idID!None1—No
keyString!None1—No

OBJECT Feature

FieldTypeArgumentsComplexityDescriptionDeprecated
idID!None1—No
keyString!None1—No

OBJECT LegacyPlan

FieldTypeArgumentsComplexityDescriptionDeprecated
idID!None1—No

INTERFACE Node

FieldTypeArgumentsComplexityDescriptionDeprecated
idID!None1—No

Curated examples

Plan with entitlements

query PlanWithEntitlements($key: String!) {
  plan(key: $key) {
    id
    key
    entitlements {
      featureKey
      value
    }
  }
}

Variables

{
  "key": "starter_monthly"
}

Customers with subscriptions

query CustomersWithSubscriptions($first: Int) {
  customers(first: $first) {
    id
    externalId
    subscriptions {
      id
      planKey
    }
  }
}

Variables

{
  "first": 20
}

Single entitlement check

query SingleEntitlement($customerId: ID!, $featureKey: String!) {
  entitlementCheck(customerId: $customerId, featureKey: $featureKey) {
    allowed
    reason
  }
}

Variables

{
  "customerId": "cust_dev_1001",
  "featureKey": "analytics_export"
}

Usage data

query UsageData($customerId: ID!, $meterKey: String!) {
  usageCounter(customerId: $customerId, meterKey: $meterKey) {
    meterKey
    current
    limit
  }
}

Variables

{
  "customerId": "cust_dev_1001",
  "meterKey": "api_requests"
}

Credit balances

query CreditBalances($customerId: ID!) {
  creditBalance(customerId: $customerId) {
    available
    pending
  }
}

Variables

{
  "customerId": "cust_dev_1001"
}

Shared query seed

Shared: Plan Health

query SharedPlanHealth($key: String!) {
  plan(key: $key) {
    id
    key
    name
  }
}

Shared: Usage Check

query SharedUsageCheck($customerId: ID!, $meterKey: String!) {
  usageCounter(customerId: $customerId, meterKey: $meterKey) {
    current
    limit
  }
}

Loading GraphQL schema...

Sign in to execute GraphQL queries

You can browse schema and examples without logging in. Sign in and provide your own API token to execute live queries.

Endpoint: https://app.monetizekit.app/api/graphql

Query complexity

2/100

Pagination guidance: use first/after or last/before on connection fields to control response size.

Sign in to view live GraphQL responses

Response output is shown after authenticated query execution.

Was this page helpful?