{"_id":"57c8705659cd4b0e00b88924","user":"55fae9d4825d5f19001fa379","parentDoc":null,"project":"55faeacad0e22017005b8265","__v":1,"category":{"_id":"5601ae926811d00d00ceb487","pages":["561d51f56386060d00e06016","561d52469e8e1f0d00983290","561d527a31d9630d001eb5ce","561d52ef9e8e1f0d00983292","56411e7f2a2a4c0d00c69773","564a36d43242592b00338a74","566b368c1766bf0d00e73970","569805328d2a770d00d2fd3c","569806dd69393517000c846d","5698073e3503e40d0061f4f3","56aa5dce09cb9c0d00f0c8c3","56cf5b5f287eb20b009f9f26"],"project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","__v":12,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-22T19:40:02.922Z","from_sync":false,"order":4,"slug":"ordering-guide","title":"Ordering Guide"},"version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":33,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-01T18:15:50.023Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"post","results":{"codes":[{"status":200,"name":"","code":"{\n  \"order_id\": \"01af5259-64d9-4e16-a161-d6d5e6f3e958\",\n  \"acquisitions\": [\n    {\n      \"acquisition_id\": \"CATID1\",\n      \"state\": \"submitted\"\n    },\n    {\n      \"acquisition_id\": \"CATID2\",\n      \"state\": \"submitted\"\n    }\n  ],\n  \"callback\": \"http://domainname.tld/callbackHandler\"\n}","language":"json"}]},"settings":"56143e6a1a8caf0d00689482","examples":{"codes":[{"code":"{ \n  \"acquisitionIds\": [ \"CATID1\", \"CATID2\" ],\n  \"callback\": \"http://domainname.tld/callbackHandler\"\n}","language":"json"}]},"auth":"required","params":[],"url":"/orders/v2/ordercb"},"isReference":false,"order":5,"body":"The JSON request must include the acquisition IDs (catIDs) and the url that will receive the callback message.\n\nCallback messages are sent for the entire order, not for individual acquisition IDs. \n\nCallback messages are sent when the order has either completed or failed.\n\nCallbacks are not sent for acquisitions that have already been delivered. \n\nTo check the status of your order, use the order ID to query orders/v2/orders for status. See [Get Order Status v2](doc:get-order-status-v2).","excerpt":"To place an order and get a callback notification when the order has completed or failed, use the OrderCB API. If you don't need callbacks, use the Ordering V2 API.","slug":"place-order-with-callbacks","type":"endpoint","title":"Place Order with Callbacks"}

postPlace Order with Callbacks

To place an order and get a callback notification when the order has completed or failed, use the OrderCB API. If you don't need callbacks, use the Ordering V2 API.

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format


Documentation

The JSON request must include the acquisition IDs (catIDs) and the url that will receive the callback message. Callback messages are sent for the entire order, not for individual acquisition IDs. Callback messages are sent when the order has either completed or failed. Callbacks are not sent for acquisitions that have already been delivered. To check the status of your order, use the order ID to query orders/v2/orders for status. See [Get Order Status v2](doc:get-order-status-v2).

User Information

Try It Out


post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}