---
title: Resource Fetching API
description: >-
  Use the standard web <code>fetch()</code> method to make authenticated calls
  to the <a href='https://shopify.dev/docs/api/admin-graphql/latest'>Shopify
  GraphQL Admin API</a> and to your app's
api_name: app-home
source_url:
  html: >-
    https://shopify.dev/docs/api/app-home/apis/authentication-and-data/resource-fetching-api
  md: >-
    https://shopify.dev/docs/api/app-home/apis/authentication-and-data/resource-fetching-api.md
---

# Resource Fetching API

Use the standard web `fetch()` method to make authenticated calls to the [Shopify GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql/latest) and to your app's backend.

Because your app runs in an iframe, it can't natively make these requests. When you make a call using `fetch()`, App Bridge intercepts the method and handles authentication automatically.

For requests to the Shopify GraphQL Admin API, use the `shopify:admin/` URL scheme, and ensure that [Direct API access](https://shopify.dev/docs/apps/build/cli-for-apps/app-configuration#admin) is enabled for your app in its TOML configuration file.

For requests to your app's domain and subdomains, App Bridge automatically adds an [OpenID Connect ID Token](https://openid.net/specs/openid-connect-core-1_0.html#IDToken%5C) in the `Authorization` header, along with the shop's locale in `Accept-Language`.

You can disable interception of the `fetch()` method by using the [disabledFeatures](https://shopify.dev/docs/api/app-home/apis/config#properties-propertydetail-disabledfeatures) configuration option. For more information about general usage of `fetch()`, see the [Fetch API documentation](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).

### Use cases

* **Authenticated requests:** Send fetch requests to your app's backend that are automatically authenticated with an ID token.
* **API calls:** Make authenticated calls to your app's API without manually managing authorization headers.
* **Subdomain support:** Access resources on your application domain and subdomains with automatic authentication.
* **Direct API access:** Use the global `fetch` function with built-in Shopify authentication for seamless data fetching.

Examples

### Examples

* ####

  ##### Description

  Make a fetch request to your app's backend. App Bridge automatically adds an authentication token and the shop's locale to the request headers.

  ##### js

  ```js
  const response = await fetch('/api/products');
  const data = await response.json();
  console.log(data);
  ```

* ####

  ##### Description

  Send custom headers alongside App Bridge's automatic authentication. App Bridge automatically sets the \`Authorization\` and \`Accept-Language\` headers for requests to your app's domain, but you can add additional headers as needed.

  ##### js

  ```js
  fetch('/api/endpoint', {
    headers: {'accept-language': 'fr'},
  });
  ```

* ####

  ##### Description

  Query the Shopify GraphQLAdmin API directly from the browser using the \`shopify:admin/\` URL scheme. This requires Direct API access to be enabled in your app configuration. App Bridge routes these requests through the host frame, so they don't require a backend server.

  ##### js

  ```js
  const res = await fetch('shopify:admin/api/graphql.json', {
    method: 'POST',
    body: JSON.stringify({
      query: `
        query GetProduct($id: ID!) {
          product(id: $id) {
            title
          }
        }
      `,
      variables: {id: 'gid://shopify/Product/1234567890'},
    }),
  });

  const {data} = await res.json();
  console.log(data);
  ```

* ####

  ##### Description

  Pin your GraphQL Admin API requests to a specific API version instead of using the default. This is useful when you need to rely on behaviour from a particular API version.

  ##### js

  ```js
  const res = await fetch('shopify:admin/api/2025-04/graphql.json', {
    method: 'POST',
    body: JSON.stringify({
      query: `
        query GetProduct($id: ID!) {
          product(id: $id) {
            title
          }
        }
      `,
      variables: {id: 'gid://shopify/Product/1234567890'},
    }),
  });

  const {data} = await res.json();
  console.log(data);
  ```

***