An asynchronous long-running operation to fetch data in bulk or to bulk import data.
Bulk operations are created using the `bulkOperationRunQuery` or `bulkOperationRunMutation` mutation. After
they are created, clients should poll the `status` field for updates. When `COMPLETED`, the `url` field contains
a link to the data in [JSONL](http://jsonlines.org/) format.
Refer to the [bulk operations guide](https://shopify.dev/api/usage/bulk-operations/imports) for more details.
Access Scopes
Fields
completedAt:
DateTime -
When the bulk operation was successfully completed.
createdAt:
DateTime! -
When the bulk operation was created.
errorCode:
BulkOperationErrorCode -
Error code for failed operations.
fileSize:
UnsignedInt64 -
File size in bytes of the file in the `url` field.
objectCount:
UnsignedInt64! -
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.
partialDataUrl:
URL -
The URL that points to the partial or incomplete response data (in [JSONL](http://jsonlines.org/) 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.
query:
String! -
GraphQL query document specified in `bulkOperationRunQuery`.
rootObjectCount:
UnsignedInt64! -
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.
status:
BulkOperationStatus! -
Status of the bulk operation.
type:
BulkOperationType! -
The bulk operation's type.
url:
URL -
The URL that points to the response data in [JSONL](http://jsonlines.org/) format.
The URL expires 7 days after the operation completes.
Connections
Related queries
currentBulkOperation
Returns the current app's most recent BulkOperation. Apps can run one bulk query and one bulk mutation operation at a time, by shop.
Related mutations
bulkOperationCancel
Starts the cancelation process of a running bulk operation.
There may be a short delay from when a cancelation starts until the operation is actually canceled.
bulkOperationRunMutation
Creates and runs a bulk operation mutation.
To learn how to bulk import large volumes of data asynchronously, refer to the
[bulk import data guide](https://shopify.dev/api/usage/bulk-operations/imports).
bulkOperationRunQuery
Creates and runs a bulk operation query.
See the [bulk operations guide](https://shopify.dev/api/usage/bulk-operations/queries) for more details.