Choose a version:

currentBulkOperation

query

Deprecated. Use bulkOperations with status filter instead.

Returns the current app's most recent BulkOperation. Apps can run one bulk query and one bulk mutation operation at a time per shop.

The operation type parameter determines whether to retrieve the most recent query or mutation bulk operation. Use this query to check the operation's status, track its progress, and retrieve the result URL when it completes.

Anchor to Arguments

Arguments

Anchor to typetype

•BulkOperationType

Default:QUERY

The current bulk operation's type.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to BulkOperationBulkOperation

•BulkOperation

An asynchronous operation that exports large datasets or imports data in bulk. Create bulk operations using bulkOperationRunQuery to export data or bulkOperationRunMutation to import data.

After creation, check the status field to track progress. When completed, the url field contains a link to download results in JSONL format. The objectCount field shows the running total of processed objects, while rootObjectCount tracks only root-level objects in nested queries.

If an operation fails but retrieves partial data, then the partialDataUrl field provides access to incomplete results.

Note

url and partialDataUrl values expire after seven days.

Learn more about exporting and importing data in bulk.

Anchor to completedAtcompletedAt

•DateTime

When the bulk operation was successfully completed.

Anchor to createdAtcreatedAt

•DateTime!

non-null

When the bulk operation was created.

Anchor to errorCodeerrorCode

•BulkOperationErrorCode

Error code for failed operations.

Anchor to fileSizefileSize

•UnsignedInt64

File size in bytes of the file in the url field.

Anchor to idid

•ID!

non-null

A globally-unique ID.

Anchor to objectCountobjectCount

•UnsignedInt64!

non-null

A running count of all the objects processed. For example, when fetching all the products and their variants, this field counts both products and variants. This field can be used to track operation progress.

Anchor to partialDataUrlpartialDataUrl

•URL

The URL that points to the partial or incomplete response data (in JSONL format) that was returned by a failed operation. The URL expires 7 days after the operation fails. Returns null when there's no data available.

Anchor to queryquery

•String!

non-null

GraphQL query document specified in bulkOperationRunQuery.

Anchor to rootObjectCountrootObjectCount

•UnsignedInt64!

non-null

A running count of all the objects that are processed at the root of the query. For example, when fetching all the products and their variants, this field only counts products. This field can be used to track operation progress.

Anchor to statusstatus

•BulkOperationStatus!

non-null

Status of the bulk operation.

Anchor to typetype

•BulkOperationType!

non-null

The bulk operation's type.

Anchor to urlurl

•URL

The URL that points to the response data in JSONL format. The URL expires 7 days after the operation completes.

Was this section helpful?

Examples

Get the currentBulkOperation for a query

Description

The following query retrieves the currentBulkOperation for a query.

Query

query {
  currentBulkOperation(type: QUERY) {
    id
    type
    status
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { currentBulkOperation(type: QUERY) { id type status } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    currentBulkOperation(type: QUERY) {
      id
      type
      status
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    currentBulkOperation(type: QUERY) {
      id
      type
      status
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    currentBulkOperation(type: QUERY) {
      id
      type
      status
    }
  }`,
});

Response

{
  "currentBulkOperation": {
    "id": "gid://shopify/BulkOperation/726270413",
    "type": "QUERY",
    "status": "CREATED"
  }
}

Get the currentBulkOperation for a query

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query {

currentBulkOperation(type: QUERY) {

type

status

}

}`,

);

const json = await response.json();

return json.data;

}

GQL

query {
  currentBulkOperation(type: QUERY) {
    id
    type
    status
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { currentBulkOperation(type: QUERY) { id type status } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    currentBulkOperation(type: QUERY) {
      id
      type
      status
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    currentBulkOperation(type: QUERY) {
      id
      type
      status
    }
  }`,
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    currentBulkOperation(type: QUERY) {
      id
      type
      status
    }
  }
QUERY

response = client.query(query: query)

Response

JSON

{

"currentBulkOperation": {

"id": "gid://shopify/BulkOperation/726270413",

"type": "QUERY",

"status": "CREATED"

}