# currentAppInstallation - admin-graphql - QUERY Version: 2024-10 ## Description Return the AppInstallation for the currently authenticated App. ### Access Scopes ## Arguments ## Returns * [accessScopes](/docs/api/admin-graphql/2024-10/objects/AccessScope): AccessScope! The access scopes granted to the application by a merchant during installation. * [activeSubscriptions](/docs/api/admin-graphql/2024-10/objects/AppSubscription): AppSubscription! The active application subscriptions billed to the shop on a recurring basis. * [app](/docs/api/admin-graphql/2024-10/objects/App): App! Application which is installed. * [channel](/docs/api/admin-graphql/2024-10/objects/Channel): Channel Channel associated with the installed application. * [id](/docs/api/admin-graphql/2024-10/scalars/ID): ID! A globally-unique ID. * [launchUrl](/docs/api/admin-graphql/2024-10/scalars/URL): URL! The URL to launch the application. * [metafield](/docs/api/admin-graphql/2024-10/objects/Metafield): Metafield A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. * [privateMetafield](/docs/api/admin-graphql/2024-10/objects/PrivateMetafield): PrivateMetafield Returns a private metafield by namespace and key that belongs to the resource. * [publication](/docs/api/admin-graphql/2024-10/objects/Publication): Publication The publication associated with the installed application. * [subscriptions](/docs/api/admin-graphql/2024-10/objects/AppSubscription): AppSubscription! Subscriptions charge to a shop on a recurring basis. * [uninstallUrl](/docs/api/admin-graphql/2024-10/scalars/URL): URL The URL to uninstall the application. ## Examples ### Get a list of access scopes Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query AccessScopeList { currentAppInstallation { accessScopes { handle } } }\"\n}'\n" Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: `query AccessScopeList {\n currentAppInstallation {\n accessScopes {\n handle\n }\n }\n }`,\n});\n" Ruby example: "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n query AccessScopeList {\n currentAppInstallation {\n accessScopes {\n handle\n }\n }\n }\nQUERY\n\nresponse = client.query(query: query)\n" Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n query AccessScopeList {\n currentAppInstallation {\n accessScopes {\n handle\n }\n }\n }`,\n);\n\nconst data = await response.json();\n" Graphql query: "query AccessScopeList {\n currentAppInstallation {\n accessScopes {\n handle\n }\n }\n}" #### Graphql Input null #### Graphql Response { "data": { "currentAppInstallation": { "accessScopes": [ { "handle": "read_all_orders" }, { "handle": "read_all_subscription_contracts" }, { "handle": "read_analytics_overviews" }, { "handle": "read_billing" }, { "handle": "read_checkouts" }, { "handle": "read_discovery" }, { "handle": "read_discovery_synonym_groups" }, { "handle": "read_payment_settings" }, { "handle": "read_subscription_plans" }, { "handle": "read_users" }, { "handle": "read_customer_merge" }, { "handle": "write_admin_shop_settings" }, { "handle": "write_analytics_overviews" }, { "handle": "write_apps" }, { "handle": "write_brand" }, { "handle": "write_brand_settings" }, { "handle": "write_content" }, { "handle": "write_customer_data_redaction_requests" }, { "handle": "write_customer_payment_methods" }, { "handle": "write_customers" }, { "handle": "write_discounts" }, { "handle": "write_discovery" }, { "handle": "write_discovery_synonym_groups" }, { "handle": "write_draft_orders" }, { "handle": "write_files" }, { "handle": "write_fulfillments" }, { "handle": "write_gift_cards" }, { "handle": "write_home" }, { "handle": "write_inventory" }, { "handle": "write_locations" }, { "handle": "write_marketing_events" }, { "handle": "write_media_processing" }, { "handle": "write_merchant_managed_fulfillment_orders" }, { "handle": "write_metaobjects" }, { "handle": "write_metaobject_definitions" }, { "handle": "write_notifications" }, { "handle": "write_online_store" }, { "handle": "write_online_store_pages" }, { "handle": "write_online_store_navigation" }, { "handle": "write_order_edits" }, { "handle": "write_orders" }, { "handle": "write_order_refunds" }, { "handle": "write_payment_mandate" }, { "handle": "write_price_rules" }, { "handle": "write_products" }, { "handle": "write_publications" }, { "handle": "write_reports" }, { "handle": "write_script_tags" }, { "handle": "write_shipping" }, { "handle": "write_themes" }, { "handle": "write_third_party_fulfillment_orders" }, { "handle": "write_customer_merge" }, { "handle": "write_companies" }, { "handle": "read_analytics" }, { "handle": "read_admin_shop_settings" }, { "handle": "read_apps" }, { "handle": "read_brand" }, { "handle": "read_brand_settings" }, { "handle": "read_content" }, { "handle": "read_customer_data_redaction_requests" }, { "handle": "read_customer_payment_methods" }, { "handle": "read_customers" }, { "handle": "read_discounts" }, { "handle": "read_draft_orders" }, { "handle": "read_files" }, { "handle": "read_fulfillments" }, { "handle": "read_gift_cards" }, { "handle": "read_home" }, { "handle": "read_inventory" }, { "handle": "read_locations" }, { "handle": "read_marketing_events" }, { "handle": "read_media_processing" }, { "handle": "read_merchant_managed_fulfillment_orders" }, { "handle": "read_metaobjects" }, { "handle": "read_metaobject_definitions" }, { "handle": "read_notifications" }, { "handle": "read_online_store" }, { "handle": "read_online_store_pages" }, { "handle": "read_online_store_navigation" }, { "handle": "read_order_edits" }, { "handle": "read_orders" }, { "handle": "read_payment_mandate" }, { "handle": "read_price_rules" }, { "handle": "read_products" }, { "handle": "read_publications" }, { "handle": "read_reports" }, { "handle": "read_script_tags" }, { "handle": "read_shipping" }, { "handle": "read_themes" }, { "handle": "read_third_party_fulfillment_orders" }, { "handle": "read_companies" } ] } } }