---
title: BulkOperationRunQueryPayload - GraphQL Admin
description: Return type for `bulkOperationRunQuery` mutation.
api_version: 2025-10
api_name: admin
type: payload
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/BulkOperationRunQueryPayload
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/BulkOperationRunQueryPayload.md
---

# Bulk​Operation​Run​Query​Payload

payload

Return type for `bulkOperationRunQuery` mutation.

## Fields

* bulk​Operation

  [Bulk​Operation](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation)

  The newly created bulk operation.

* user​Errors

  [\[Bulk​Operation​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperationUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [bulk​Operation​Run​Query](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationRunQuery)

  mutation

  Creates and runs a [bulk operation](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation) to fetch data asynchronously. The operation processes your GraphQL query in the background and returns results in a [JSONL](http://jsonlines.org/) file when complete.

  Apps can run one bulk query operation and one bulk mutation operation at a time per shop. The query must include at least one connection field and supports up to five connections with a maximum nesting depth of two levels.

  ***

  Note

  Results remain available for seven days after completion.

  ***

  For more information, see the [bulk operations guide](https://shopify.dev/docs/api/usage/bulk-operations/queries).

  * query

    [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    required

    ### Arguments

    The query to be executed in bulk.

  * group​Objects

    [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

    requiredDefault:true

    Whether to group objects under their corresponding parent objects in the JSONL output. Grouping is costly, causes bulk operations to take longer to complete, and increases the chances of failures such as timeouts.

  ***

***

## Map

### Mutations with this payload

* [bulk​Operation​Run​Query](https://shopify.dev/docs/api/admin-graphql/latest/types/bulkOperationRunQuery)