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
}