--- title: "Create, update, upsert, or delete orders asynchronously in bulk" method: POST path: "/v1/orders/bulk" tags: ["Order"] --- # Create, update, upsert, or delete orders asynchronously in bulk `POST /v1/orders/bulk` Submit a bulk operation to create, update, upsert, or delete multiple orders asynchronously. Returns a bulk operation ID that can be polled for results using the GET bulk endpoint. ## Request body - union[] - union - CreateOrderBulkPayload - `action` 'create', required - `data` OrderInput, required — Order input for creating an order. - `externalId` string, nullable — Order unique identifier from an external system. - `pickupAddress` string, nullable — The full address in one line for the pickup location. Format: [Number] [Street], [second line], [city], [state], [zip code]. - `pickupPlaceId` string, nullable — Google place id for the pickup location. - `pickupPhoneNumber` string, nullable — The phone number to contact at the pickup location in the form: '+15555555555' - `pickupBusinessName` string, nullable — Pickup business name at the origin. Limited to 80 characters. - `pickupFirstName` string, nullable — First name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters. - `pickupLastName` string, nullable — Last name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters. - `pickupInstructions` string, nullable — Any special instructions for pickup. Limited to 280 characters. - `pickupStoreLocationId` string, nullable — A unique identifier for store location created in Nash. - `pickupExternalStoreLocationId` string, nullable — The external identifier used for your store. - `pickupStoreLocationIds` string[], nullable — A list of store location IDs (internal or external) to consider for the Order. The optimal store will be selected and returned in the response in `pickupStoreLocationId` and/or `pickupStoreLocationExternalId`. - `pickupZoneIds` string[], nullable — A list of zone IDs to consider for the Order. The pickup store location will be selected later via selected delivery window. - `pickupBarcodes` string[], nullable — Array containing barcode values that are required to be scanned at the pickup waypoint. - `pickupEmail` string, nullable — The email of the contact at the pickup location. - `dropoffAddress` string, nullable — The full address in one line for the dropoff location. Format: [Number] [Street], [second line], [city], [state], [zip code]. - `dropoffPlaceId` string, nullable — Google place id for the dropoff location. - `dropoffPhoneNumber` string, nullable — The phone number to contact at the dropoff location in the form: '+15555555555' - `dropoffBusinessName` string, nullable — Name of the business at the destination. Should be left empty if there is no business. Limited to 80 characters. - `dropoffFirstName` string, nullable — First name of the contact at the destination. Limited to 80 characters. - `dropoffLastName` string, nullable — Last name of the contact at the destination. Limited to 80 characters. - `dropoffInstructions` string, nullable — Any special instructions for dropoff. Limited to 280 characters. - `dropoffBarcodes` string[], nullable — Array containing barcode values/types that are required to be scanned at the dropoff waypoint. - `dropoffEmail` string, nullable — The email of the contact at the dropoff location. - `deliveryMode` string, nullable — 'now' or 'scheduled' when the delivery should be scheduled - `pickupStartTime` string, date-time, nullable — The earliest pickup time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `pickupEndTime` string, date-time, nullable — The latest pickup time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `dropoffStartTime` string, date-time, nullable — The earliest dropoff time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `dropoffEndTime` string, date-time, nullable — The latest dropoff time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `deliveryWindowId` string, nullable — Delivery window id if using Nash delivery windows - `description` string, nullable — Order description and notes. Limited to 280 characters. - `itemsCount` integer, nullable — The number of items in this order - `currency` string, nullable — Local currency - `valueCents` union — Order value in cents - integer - string - `tipAmountCents` integer, nullable — Tip paid to the driver in cents - `requirements` union — Package requirements. - PackageRequirements[] - string[] - `minimumVehicleSize` 'any' | 'bike' | 'motorbike' | 'cargobike' | 'sedan' | 'car' | 'suv' | 'pickup_truck' | 'pickup' | 'van' | 'large_van' | 'extra_large_van' | 'truck', nullable — The requested minimum vehicle size. Allowed values: ['any', 'bike', 'motorbike', 'cargobike', 'sedan', 'car', 'suv', 'pickup_truck', 'pickup', 'van', 'large_van', 'extra_large_van', 'truck'] - `dispatchStrategyId` string, nullable — The dispatch strategy id (or option group id) to be associated with the order. Note: Best practice is to allow automations to control dispatch strategy and not send the dispatch strategy id in the request. - `orderMetadata` object, nullable — Key-value data to attach to this order. - `tags` string[], nullable — Optional order tags, they will be included in every response - `referenceId` string, nullable — A non-unique identifier for orders, visible to the courier if supported by the provider. - `pickupAddressNumber` string, nullable — The number on a house. - `pickupAddressSecondarynumber` string, nullable — Secondary number on an address e.g. an apartment building. - `pickupAddressFormattedStreet` string, nullable — The street of the address. - `pickupAddressCity` string, nullable — The city of the pickup address. - `pickupAddressCounty` string, nullable — The county associated with the pickup address. - `pickupAddressState` string, nullable — The state of the pickup address. - `pickupAddressZip` string, nullable — The zip or postal code of the pickup address. - `pickupAddressCountry` string, nullable — The ISO 3166-1 alpha-2 country code of the pickup address. - `pickupLat` number, nullable — The pickup latitude coordinate. - `pickupLng` number, nullable — The pickup longitude coordinate. - `dropoffAddressNumber` string, nullable — The number on a house. - `dropoffAddressSecondarynumber` string, nullable — Secondary number on an address e.g. an apartment building. - `dropoffAddressFormattedStreet` string, nullable — The street of the address. - `dropoffAddressCity` string, nullable — The city of the dropoff address. - `dropoffAddressCounty` string, nullable — The county associated with the dropoff address. - `dropoffAddressState` string, nullable — The state of the dropoff address. - `dropoffAddressZip` string, nullable — The zip or postal code of the dropoff address. - `dropoffAddressCountry` string, nullable — The ISO 3166-1 alpha-2 country code of the dropoff address. - `dropoffLat` number, nullable — The dropoff latitude coordinate. - `dropoffLng` number, nullable — The dropoff longitude coordinate. - `weight` union — The total weight of the package in kilograms (kg) - number - integer - string - `height` union — The total height of the package in centimeters (cm) - number - integer - `width` union — The total width of the package in centimeters (cm) - number - integer - `depth` union — The total depth of the package in centimeters (cm) - number - integer - `items` ItemInput[], nullable — Lists of items in the delivery - `id` string, nullable — The merchant ID of the item - `description` string, nullable — The description of the item - `count` integer, nullable — The quantity of the item - `dimensions` Dimensions - `height` union — The height of the item in centimeters (cm) - … - `width` union — The width of the item in centimeters (cm) - … - `depth` union — The depth of the item in centimeters (cm) - … - `weight` union — The weight of the item in kilograms (kg) - number - integer - `valueCents` integer, nullable — The value of the item in cents - `requirements` string[], nullable — List of requirements for this item - `category` string, nullable — The category of the item - `barcode` string, nullable — Barcode value for this item. - `metadata` object, nullable — Key-value data to attach to this item. - `subItems` SubItemInput[], nullable — The nested sub-items - `id` string, nullable — The merchant ID of the item - `description` string, nullable — The description of the item - `count` integer, nullable — The quantity of the item - `dimensions` Dimensions - … - `weight` union — The weight of the item in kilograms (kg) - … - `valueCents` integer, nullable — The value of the item in cents - `requirements` string[], nullable — List of requirements for this item - `category` string, nullable — The category of the item - `barcode` string, nullable — Barcode value for this item. - `metadata` object, nullable — Key-value data to attach to this item. - `sku` string, nullable — The SKU of the sub-item - `substitution` SubstitutionObject - … - `subItems` SubItemInput[], nullable — The nested sub-items - `optimizationParameters` OptimizationParameters - `pickupDoorstepTimeSeconds` integer, nullable — Length of time (in seconds) it take the courier at the pickup location's doorstep. - `dropoffDoorstepTimeSeconds` integer, nullable — Length of time (in seconds) it take the courier at the dropoff location's doorstep. - `costsByMetric` object, nullable — The cost metric to use for the order - `clusterLabel` string, nullable — The cluster label for the order - `mxLabel` string, nullable — The mutually exclusive label for the order - `assignmentPriority` integer, nullable — The assignment priority for the order - `sequencePriority` integer, nullable — The sequence priority for the order - `sequenceGroup` string, nullable — The sequence group for the order - `pickupPayment` PickupPayment - `barcode` PickupPaymentBarcode - `type` string, nullable — The barcode symbology (e.g. CODE128, QR). - `value` string, nullable — The barcode value the courier should present at pickup. - `providerCard` boolean, nullable — If true, the courier pays for the order at pickup using a provider-issued card. - `reapplyAutomations` boolean, nullable — If set to true, the order will be re-evaluated with automations. - `maxDeliveryFeeCents` integer, nullable — The maximum delivery fee for the order in cents. This will override the dispatch strategy max delivery fee if both are set. - UpdateOrderBulkPayload - `action` 'update', required - `data` UpdateOrderInput, required - `externalId` string, nullable — Order unique identifier from an external system. - `pickupAddress` string, nullable — The full address in one line for the pickup location. Format: [Number] [Street], [second line], [city], [state], [zip code]. - `pickupPlaceId` string, nullable — Google place id for the pickup location. - `pickupPhoneNumber` string, nullable — The phone number to contact at the pickup location in the form: '+15555555555' - `pickupBusinessName` string, nullable — Pickup business name at the origin. Limited to 80 characters. - `pickupFirstName` string, nullable — First name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters. - `pickupLastName` string, nullable — Last name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters. - `pickupInstructions` string, nullable — Any special instructions for pickup. Limited to 280 characters. - `pickupStoreLocationId` string, nullable — A unique identifier for store location created in Nash. - `pickupExternalStoreLocationId` string, nullable — The external identifier used for your store. - `pickupStoreLocationIds` string[], nullable — A list of store location IDs (internal or external) to consider for the Order. The optimal store will be selected and returned in the response in `pickupStoreLocationId` and/or `pickupStoreLocationExternalId`. - `pickupZoneIds` string[], nullable — A list of zone IDs to consider for the Order. The pickup store location will be selected later via selected delivery window. - `pickupBarcodes` string[], nullable — Array containing barcode values that are required to be scanned at the pickup waypoint. - `pickupEmail` string, nullable — The email of the contact at the pickup location. - `dropoffAddress` string, nullable — The full address in one line for the dropoff location. Format: [Number] [Street], [second line], [city], [state], [zip code]. - `dropoffPlaceId` string, nullable — Google place id for the dropoff location. - `dropoffPhoneNumber` string, nullable — The phone number to contact at the dropoff location in the form: '+15555555555' - `dropoffBusinessName` string, nullable — Name of the business at the destination. Should be left empty if there is no business. Limited to 80 characters. - `dropoffFirstName` string, nullable — First name of the contact at the destination. Limited to 80 characters. - `dropoffLastName` string, nullable — Last name of the contact at the destination. Limited to 80 characters. - `dropoffInstructions` string, nullable — Any special instructions for dropoff. Limited to 280 characters. - `dropoffBarcodes` string[], nullable — Array containing barcode values/types that are required to be scanned at the dropoff waypoint. - `dropoffEmail` string, nullable — The email of the contact at the dropoff location. - `deliveryMode` string, nullable — 'now' or 'scheduled' when the delivery should be scheduled - `pickupStartTime` string, date-time, nullable — The earliest pickup time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `pickupEndTime` string, date-time, nullable — The latest pickup time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `dropoffStartTime` string, date-time, nullable — The earliest dropoff time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `dropoffEndTime` string, date-time, nullable — The latest dropoff time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `deliveryWindowId` string, nullable — Delivery window id if using Nash delivery windows - `description` string, nullable — Order description and notes. Limited to 280 characters. - `itemsCount` integer, nullable — The number of items in this order - `currency` string, nullable — Local currency - `valueCents` union — Order value in cents - integer - string - `tipAmountCents` integer, nullable — Tip paid to the driver in cents - `requirements` union — Package requirements. - PackageRequirements[] - string[] - `minimumVehicleSize` 'any' | 'bike' | 'motorbike' | 'cargobike' | 'sedan' | 'car' | 'suv' | 'pickup_truck' | 'pickup' | 'van' | 'large_van' | 'extra_large_van' | 'truck', nullable — The requested minimum vehicle size. Allowed values: ['any', 'bike', 'motorbike', 'cargobike', 'sedan', 'car', 'suv', 'pickup_truck', 'pickup', 'van', 'large_van', 'extra_large_van', 'truck'] - `dispatchStrategyId` string, nullable — The dispatch strategy id (or option group id) to be associated with the order. Note: Best practice is to allow automations to control dispatch strategy and not send the dispatch strategy id in the request. - `orderMetadata` object, nullable — Key-value data to attach to this order. - `tags` string[], nullable — Optional order tags, they will be included in every response - `referenceId` string, nullable — A non-unique identifier for orders, visible to the courier if supported by the provider. - `pickupAddressNumber` string, nullable — The number on a house. - `pickupAddressSecondarynumber` string, nullable — Secondary number on an address e.g. an apartment building. - `pickupAddressFormattedStreet` string, nullable — The street of the address. - `pickupAddressCity` string, nullable — The city of the pickup address. - `pickupAddressCounty` string, nullable — The county associated with the pickup address. - `pickupAddressState` string, nullable — The state of the pickup address. - `pickupAddressZip` string, nullable — The zip or postal code of the pickup address. - `pickupAddressCountry` string, nullable — The ISO 3166-1 alpha-2 country code of the pickup address. - `pickupLat` number, nullable — The pickup latitude coordinate. - `pickupLng` number, nullable — The pickup longitude coordinate. - `dropoffAddressNumber` string, nullable — The number on a house. - `dropoffAddressSecondarynumber` string, nullable — Secondary number on an address e.g. an apartment building. - `dropoffAddressFormattedStreet` string, nullable — The street of the address. - `dropoffAddressCity` string, nullable — The city of the dropoff address. - `dropoffAddressCounty` string, nullable — The county associated with the dropoff address. - `dropoffAddressState` string, nullable — The state of the dropoff address. - `dropoffAddressZip` string, nullable — The zip or postal code of the dropoff address. - `dropoffAddressCountry` string, nullable — The ISO 3166-1 alpha-2 country code of the dropoff address. - `dropoffLat` number, nullable — The dropoff latitude coordinate. - `dropoffLng` number, nullable — The dropoff longitude coordinate. - `weight` union — The total weight of the package in kilograms (kg) - number - integer - string - `height` union — The total height of the package in centimeters (cm) - number - integer - `width` union — The total width of the package in centimeters (cm) - number - integer - `depth` union — The total depth of the package in centimeters (cm) - number - integer - `items` ItemInput[], nullable — Lists of items in the delivery - `id` string, nullable — The merchant ID of the item - `description` string, nullable — The description of the item - `count` integer, nullable — The quantity of the item - `dimensions` Dimensions - `height` union — The height of the item in centimeters (cm) - … - `width` union — The width of the item in centimeters (cm) - … - `depth` union — The depth of the item in centimeters (cm) - … - `weight` union — The weight of the item in kilograms (kg) - number - integer - `valueCents` integer, nullable — The value of the item in cents - `requirements` string[], nullable — List of requirements for this item - `category` string, nullable — The category of the item - `barcode` string, nullable — Barcode value for this item. - `metadata` object, nullable — Key-value data to attach to this item. - `subItems` SubItemInput[], nullable — The nested sub-items - `id` string, nullable — The merchant ID of the item - `description` string, nullable — The description of the item - `count` integer, nullable — The quantity of the item - `dimensions` Dimensions - … - `weight` union — The weight of the item in kilograms (kg) - … - `valueCents` integer, nullable — The value of the item in cents - `requirements` string[], nullable — List of requirements for this item - `category` string, nullable — The category of the item - `barcode` string, nullable — Barcode value for this item. - `metadata` object, nullable — Key-value data to attach to this item. - `sku` string, nullable — The SKU of the sub-item - `substitution` SubstitutionObject - … - `subItems` SubItemInput[], nullable — The nested sub-items - `optimizationParameters` OptimizationParameters - `pickupDoorstepTimeSeconds` integer, nullable — Length of time (in seconds) it take the courier at the pickup location's doorstep. - `dropoffDoorstepTimeSeconds` integer, nullable — Length of time (in seconds) it take the courier at the dropoff location's doorstep. - `costsByMetric` object, nullable — The cost metric to use for the order - `clusterLabel` string, nullable — The cluster label for the order - `mxLabel` string, nullable — The mutually exclusive label for the order - `assignmentPriority` integer, nullable — The assignment priority for the order - `sequencePriority` integer, nullable — The sequence priority for the order - `sequenceGroup` string, nullable — The sequence group for the order - `pickupPayment` PickupPayment - `barcode` PickupPaymentBarcode - `type` string, nullable — The barcode symbology (e.g. CODE128, QR). - `value` string, nullable — The barcode value the courier should present at pickup. - `providerCard` boolean, nullable — If true, the courier pays for the order at pickup using a provider-issued card. - `reapplyAutomations` boolean, nullable — If set to true, the order will be re-evaluated with automations. - `maxDeliveryFeeCents` integer, nullable — The maximum delivery fee for the order in cents. This will override the dispatch strategy max delivery fee if both are set. - `id` string, required — The ID of the order - UpsertOrderBulkPayload - `action` 'upsert', required - `data` UpsertOrderInput, required - `externalId` string, nullable — Order unique identifier from an external system. - `pickupAddress` string, nullable — The full address in one line for the pickup location. Format: [Number] [Street], [second line], [city], [state], [zip code]. - `pickupPlaceId` string, nullable — Google place id for the pickup location. - `pickupPhoneNumber` string, nullable — The phone number to contact at the pickup location in the form: '+15555555555' - `pickupBusinessName` string, nullable — Pickup business name at the origin. Limited to 80 characters. - `pickupFirstName` string, nullable — First name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters. - `pickupLastName` string, nullable — Last name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters. - `pickupInstructions` string, nullable — Any special instructions for pickup. Limited to 280 characters. - `pickupStoreLocationId` string, nullable — A unique identifier for store location created in Nash. - `pickupExternalStoreLocationId` string, nullable — The external identifier used for your store. - `pickupStoreLocationIds` string[], nullable — A list of store location IDs (internal or external) to consider for the Order. The optimal store will be selected and returned in the response in `pickupStoreLocationId` and/or `pickupStoreLocationExternalId`. - `pickupZoneIds` string[], nullable — A list of zone IDs to consider for the Order. The pickup store location will be selected later via selected delivery window. - `pickupBarcodes` string[], nullable — Array containing barcode values that are required to be scanned at the pickup waypoint. - `pickupEmail` string, nullable — The email of the contact at the pickup location. - `dropoffAddress` string, nullable — The full address in one line for the dropoff location. Format: [Number] [Street], [second line], [city], [state], [zip code]. - `dropoffPlaceId` string, nullable — Google place id for the dropoff location. - `dropoffPhoneNumber` string, nullable — The phone number to contact at the dropoff location in the form: '+15555555555' - `dropoffBusinessName` string, nullable — Name of the business at the destination. Should be left empty if there is no business. Limited to 80 characters. - `dropoffFirstName` string, nullable — First name of the contact at the destination. Limited to 80 characters. - `dropoffLastName` string, nullable — Last name of the contact at the destination. Limited to 80 characters. - `dropoffInstructions` string, nullable — Any special instructions for dropoff. Limited to 280 characters. - `dropoffBarcodes` string[], nullable — Array containing barcode values/types that are required to be scanned at the dropoff waypoint. - `dropoffEmail` string, nullable — The email of the contact at the dropoff location. - `deliveryMode` string, nullable — 'now' or 'scheduled' when the delivery should be scheduled - `pickupStartTime` string, date-time, nullable — The earliest pickup time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `pickupEndTime` string, date-time, nullable — The latest pickup time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `dropoffStartTime` string, date-time, nullable — The earliest dropoff time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `dropoffEndTime` string, date-time, nullable — The latest dropoff time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ' - `deliveryWindowId` string, nullable — Delivery window id if using Nash delivery windows - `description` string, nullable — Order description and notes. Limited to 280 characters. - `itemsCount` integer, nullable — The number of items in this order - `currency` string, nullable — Local currency - `valueCents` union — Order value in cents - integer - string - `tipAmountCents` integer, nullable — Tip paid to the driver in cents - `requirements` union — Package requirements. - PackageRequirements[] - string[] - `minimumVehicleSize` 'any' | 'bike' | 'motorbike' | 'cargobike' | 'sedan' | 'car' | 'suv' | 'pickup_truck' | 'pickup' | 'van' | 'large_van' | 'extra_large_van' | 'truck', nullable — The requested minimum vehicle size. Allowed values: ['any', 'bike', 'motorbike', 'cargobike', 'sedan', 'car', 'suv', 'pickup_truck', 'pickup', 'van', 'large_van', 'extra_large_van', 'truck'] - `dispatchStrategyId` string, nullable — The dispatch strategy id (or option group id) to be associated with the order. Note: Best practice is to allow automations to control dispatch strategy and not send the dispatch strategy id in the request. - `orderMetadata` object, nullable — Key-value data to attach to this order. - `tags` string[], nullable — Optional order tags, they will be included in every response - `referenceId` string, nullable — A non-unique identifier for orders, visible to the courier if supported by the provider. - `pickupAddressNumber` string, nullable — The number on a house. - `pickupAddressSecondarynumber` string, nullable — Secondary number on an address e.g. an apartment building. - `pickupAddressFormattedStreet` string, nullable — The street of the address. - `pickupAddressCity` string, nullable — The city of the pickup address. - `pickupAddressCounty` string, nullable — The county associated with the pickup address. - `pickupAddressState` string, nullable — The state of the pickup address. - `pickupAddressZip` string, nullable — The zip or postal code of the pickup address. - `pickupAddressCountry` string, nullable — The ISO 3166-1 alpha-2 country code of the pickup address. - `pickupLat` number, nullable — The pickup latitude coordinate. - `pickupLng` number, nullable — The pickup longitude coordinate. - `dropoffAddressNumber` string, nullable — The number on a house. - `dropoffAddressSecondarynumber` string, nullable — Secondary number on an address e.g. an apartment building. - `dropoffAddressFormattedStreet` string, nullable — The street of the address. - `dropoffAddressCity` string, nullable — The city of the dropoff address. - `dropoffAddressCounty` string, nullable — The county associated with the dropoff address. - `dropoffAddressState` string, nullable — The state of the dropoff address. - `dropoffAddressZip` string, nullable — The zip or postal code of the dropoff address. - `dropoffAddressCountry` string, nullable — The ISO 3166-1 alpha-2 country code of the dropoff address. - `dropoffLat` number, nullable — The dropoff latitude coordinate. - `dropoffLng` number, nullable — The dropoff longitude coordinate. - `weight` union — The total weight of the package in kilograms (kg) - number - integer - string - `height` union — The total height of the package in centimeters (cm) - number - integer - `width` union — The total width of the package in centimeters (cm) - number - integer - `depth` union — The total depth of the package in centimeters (cm) - number - integer - `items` ItemInput[], nullable — Lists of items in the delivery - `id` string, nullable — The merchant ID of the item - `description` string, nullable — The description of the item - `count` integer, nullable — The quantity of the item - `dimensions` Dimensions - `height` union — The height of the item in centimeters (cm) - … - `width` union — The width of the item in centimeters (cm) - … - `depth` union — The depth of the item in centimeters (cm) - … - `weight` union — The weight of the item in kilograms (kg) - number - integer - `valueCents` integer, nullable — The value of the item in cents - `requirements` string[], nullable — List of requirements for this item - `category` string, nullable — The category of the item - `barcode` string, nullable — Barcode value for this item. - `metadata` object, nullable — Key-value data to attach to this item. - `subItems` SubItemInput[], nullable — The nested sub-items - `id` string, nullable — The merchant ID of the item - `description` string, nullable — The description of the item - `count` integer, nullable — The quantity of the item - `dimensions` Dimensions - … - `weight` union — The weight of the item in kilograms (kg) - … - `valueCents` integer, nullable — The value of the item in cents - `requirements` string[], nullable — List of requirements for this item - `category` string, nullable — The category of the item - `barcode` string, nullable — Barcode value for this item. - `metadata` object, nullable — Key-value data to attach to this item. - `sku` string, nullable — The SKU of the sub-item - `substitution` SubstitutionObject - … - `subItems` SubItemInput[], nullable — The nested sub-items - `optimizationParameters` OptimizationParameters - `pickupDoorstepTimeSeconds` integer, nullable — Length of time (in seconds) it take the courier at the pickup location's doorstep. - `dropoffDoorstepTimeSeconds` integer, nullable — Length of time (in seconds) it take the courier at the dropoff location's doorstep. - `costsByMetric` object, nullable — The cost metric to use for the order - `clusterLabel` string, nullable — The cluster label for the order - `mxLabel` string, nullable — The mutually exclusive label for the order - `assignmentPriority` integer, nullable — The assignment priority for the order - `sequencePriority` integer, nullable — The sequence priority for the order - `sequenceGroup` string, nullable — The sequence group for the order - `pickupPayment` PickupPayment - `barcode` PickupPaymentBarcode - `type` string, nullable — The barcode symbology (e.g. CODE128, QR). - `value` string, nullable — The barcode value the courier should present at pickup. - `providerCard` boolean, nullable — If true, the courier pays for the order at pickup using a provider-issued card. - `reapplyAutomations` boolean, nullable — If set to true, the order will be re-evaluated with automations. - `maxDeliveryFeeCents` integer, nullable — The maximum delivery fee for the order in cents. This will override the dispatch strategy max delivery fee if both are set. - `id` string, nullable — The ID of the order - DeleteOrderBulkPayload - `action` 'delete', required - `data` OrderIdPath, required - `id` string, required — Unique reference number for the order: either order.id (starts with "ord_") or order.externalId ## Response `200` OK - BulkOperationResponse - `id` string, required — The ID of the bulk operation - `status` 'QUEUED' | 'IN_PROGRESS' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'SKIPPED' | 'SCHEDULED', required — Status of an activity. ## Other responses - `422` — Unprocessable Content --- [API](https://skmtc.net/usenash/apis/nash-api.md) · [All operations](https://skmtc.net/usenash/apis/nash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usenash/nash-api/revisions/09a23a95889b/schema)