This is a beta release of documentation for Magento 2.4, published for previewing soon-to-be-released functionality. Content in this version is subject to change. Links to the v2.4 code base may not properly resolve until the code is officially released.

Search for the status of a bulk operation

The Status Operation Search endpoint (GET /V1/bulk/?searchCriteria) allows you to search for bulk operation statuses.

You can specify any of the following fields to filter on operation statuses:

  • start_time - The time that a bulk operation started.
  • status - The operation status:
    • 1 = Complete
    • 2 = The operation failed, but you can try to perform it again.
    • 3 = The operation failed. You must change something to retry it.
    • 4 = Open
    • 5 = Rejected
  • bulk_uuid - UUID generated by an asynchronous API request or Bulk API request.
  • topic_name - Queue topic name

Sample usage:

The following call returns bulk operations that contain an error that cannot be retried.

1
2
3
4
GET <host>/rest/<store_code>/V1/bulk/?
searchCriteria[filter_groups][0][filters][0][field]=status&
searchCriteria[filter_groups][0][filters][0][value]=3&
searchCriteria[filter_groups][0][filters][0][condition_type]=eq

See Search using REST APIs for more information about the syntax of search requests.

Response:

The operation with bulk UUID c43ed402-3dd3-4100-92e2-dc5852d3009b contains a status code of 3.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
{
    "items": [
        {
            "extension_attributes": {
                "start_time": "2018-07-11 20:07:14"
            },
            "id": 4,
            "bulk_uuid": "c43ed402-3dd3-4100-92e2-dc5852d3009b",
            "topic_name": "async.magento.customer.api.accountmanagementinterface.createaccount.post",
            "serialized_data": "{\"entity_id\":null,\"entity_link\":\"\",\"meta_information\":\"{\\\"customer\\\":{\\\"email\\\":\\\"mshaw@example.com\\\",\\\"firstname\\\":\\\"Melanie Shaw\\\",\\\"lastname\\\":\\\"Doe\\\"},\\\"password\\\":\\\"Password1\\\",\\\"redirectUrl\\\":\\\"\\\"}\"}",
            "result_serialized_data": null,
            "status": 3,
            "result_message": "A customer with the same email address already exists in an associated website.",
            "error_code": 0
        },
        {
            "extension_attributes": {
                "start_time": "2018-07-11 20:07:14"
            },
            "id": 5,
            "bulk_uuid": "c43ed402-3dd3-4100-92e2-dc5852d3009b",
            "topic_name": "async.magento.customer.api.accountmanagementinterface.createaccount.post",
            "serialized_data": "{\"entity_id\":null,\"entity_link\":\"\",\"meta_information\":\"{\\\"customer\\\":{\\\"email\\\":\\\"bmartin@example.com\\\",\\\"firstname\\\":\\\"Bryce\\\",\\\"lastname\\\":\\\"Martin\\\"},\\\"password\\\":\\\"Password1\\\",\\\"redirectUrl\\\":\\\"\\\"}\"}",
            "result_serialized_data": null,
            "status": 3,
            "result_message": "A customer with the same email address already exists in an associated website.",
            "error_code": 0
        },
        {
            "extension_attributes": {
                "start_time": "2018-07-11 20:07:14"
            },
            "id": 6,
            "bulk_uuid": "c43ed402-3dd3-4100-92e2-dc5852d3009b",
            "topic_name": "async.magento.customer.api.accountmanagementinterface.createaccount.post",
            "serialized_data": "{\"entity_id\":null,\"entity_link\":\"\",\"meta_information\":\"{\\\"customer\\\":{\\\"email\\\":\\\"bmartin@example.com\\\",\\\"firstname\\\":\\\"Bryce\\\",\\\"lastname\\\":\\\"Martin\\\"},\\\"password\\\":\\\"Password1\\\",\\\"redirectUrl\\\":\\\"\\\"}\"}",
            "result_serialized_data": null,
            "status": 3,
            "result_message": "A customer with the same email address already exists in an associated website.",
            "error_code": 0
        },
        {
            "extension_attributes": {
                "start_time": "2018-07-11 20:07:14"
            },
            "id": 7,
            "bulk_uuid": "c43ed402-3dd3-4100-92e2-dc5852d3009b",
            "topic_name": "async.magento.customer.api.accountmanagementinterface.createaccount.post",
            "serialized_data": "{\"entity_id\":null,\"entity_link\":\"\",\"meta_information\":\"{\\\"customer\\\":{\\\"email\\\":\\\"tgomez@example.com\\\",\\\"firstname\\\":\\\"Teresa\\\",\\\"lastname\\\":\\\"Gomez\\\"},\\\"password\\\":\\\"Password1\\\",\\\"redirectUrl\\\":\\\"\\\"}\"}",
            "result_serialized_data": null,
            "status": 3,
            "result_message": "A customer with the same email address already exists in an associated website.",
            "error_code": 0
        },
        {
            "extension_attributes": {
                "start_time": "2018-07-11 20:58:31"
            },
            "id": 10,
            "bulk_uuid": "799a59c0-09ca-4d60-b432-2953986c1c38",
            "topic_name": "async.magento.customer.api.accountmanagementinterface.createaccount.post",
            "serialized_data": "{\"entity_id\":null,\"entity_link\":\"\",\"meta_information\":\"{\\\"customer\\\":{\\\"email\\\":\\\"bmartin@example.com\\\",\\\"firstname\\\":\\\"Bryce\\\",\\\"lastname\\\":\\\"Martin\\\"},\\\"password\\\":\\\"Password1\\\",\\\"redirectUrl\\\":\\\"\\\"}\"}",
            "result_serialized_data": null,
            "status": 3,
            "result_message": "A customer with the same email address already exists in an associated website.",
            "error_code": 0
        }
    ],
    "search_criteria": {
        "filter_groups": [
            {
                "filters": [
                    {
                        "field": "status",
                        "value": "3",
                        "condition_type": "eq"
                    }
                ]
            }
        ]
    },
    "total_count": 5
}