Recurring Charges API For GraphQL

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

Goal: Find the GraphQL equivalent for Shopify’s recurring application charges and how to query a store’s subscription state.

Key guidance:

  • Official docs are under Admin API > Billing (GraphQL). Core types:
    • AppSubscription: retrieve an app’s subscription status for a shop (e.g., active, pending).
    • AppRecurringPricing: inspect recurring price and billing interval.

Practical approach:

  • Query currentAppInstallation to fetch subscription data. Example fields shown via a working query:
    • activeSubscriptions: name, status, test, trialDays, returnUrl, createdAt, id
    • allSubscriptions (first: 10): nodes { status }
  • A screenshot and code snippet were provided, indicating GraphQL autocomplete helps discover fields.

Context/definitions:

  • AppSubscription = the object representing the shop’s subscription to your app.
  • AppRecurringPricing = pricing details (amount and interval) for recurring charges.

Outcome:

  • The question is resolved with authoritative doc links and a sample GraphQL query pattern to read recurring subscription status and pricing. No remaining open issues noted. Images/code are central to the solution.
Summarized with AI on December 17. AI used: gpt-5.
1

Hello,

Could anyone please provide me the documentation link of “Recurring Charges GraphQL API”
I have found the documentation for the REST API for it which is here.
RecurringApplicationCharge - REST

But I cannot find the same for the GraphQL. I want to check the user’s recurring charges information using graphql.
Does Shopify yet not created the same API for the GRAPHQL or am I missing something?

Thanks in advance for any help?

2

HI @sbdev

The main documentation for this is under the Billing section of the GraphQL documentation: https://shopify.dev/api/admin/graphql/reference/billing

You can use AppSubscription to find their subscription status: https://shopify.dev/api/admin/graphql/reference/billing/appsubscription

AppRecurringPricing can be used to find the price and payment interval: https://shopify.dev/api/admin/graphql/reference/billing/apprecurringpricing

Hope this helps!

3

I also faced some challenges locating the correct method. In the end, I used GraphQL autocomplete to access the subscription data for my app.

k1ltr0_0-1728088170142.png
k1ltr0_0-1728088170142.png859×944 35.7 KB

{
	currentAppInstallation {
		activeSubscriptions {
			name
			status
			test
			trialDays
			returnUrl
			createdAt
			id
		}
		allSubscriptions (first: 10) {
			nodes {
				status
			}
		}
	}
}

I hope this information is helpful.