v1

latestOpenAPI 3.1.02026-07-2296226496.3 KB
Order

Archive order

Archive (soft-delete) an order. Archived orders are hidden from default listings but can be restored using the unarchive endpoint.

delete/v1/order/{id}

Path parameters

idstring required

Unique reference number for the order: either order.id (starts with "ord_") or order.externalId

Example:ord_1234567890

Unique reference number for the order: either order.id (starts with "ord_") or order.externalId

Response

OK

idstring required

The id of the order

createdAtstring date-time required

The date and time when the order was created

externalIdstring nullable

The external id of the order

externalGroupIdstring nullable

The external group id of the order

referenceIdstring nullable

A non-unique identifier for orders, visible to the courier if supported by the provider.

portalUrlstring required

The URL of the order in the Nash portal

publicTrackingUrlstring required

The URL of the order in the public tracking system

statusstring required

The status of the order

tagsstring[] nullable required

The tags of the order

orderMetadataobject nullable

Key-value data to attach to Nash Jobs.

pickupAddressstring nullable

The pickup address of the order

pickupPlaceIdstring nullable

Google place id for the pickup location.

pickupAddressNumberstring nullable

The number on a house.

pickupAddressSecondarynumberstring nullable

Secondary number on an address e.g. an apartment building.

pickupAddressFormattedStreetstring nullable

The street of the address.

pickupAddressCitystring nullable

The city of the pickup address.

pickupAddressCountystring nullable

The county associated with the pickup address.

pickupAddressStatestring nullable

The state of the pickup address.

pickupAddressZipstring nullable

The zip or postal code of the pickup address.

pickupAddressCountrystring nullable

The ISO 3166-1 alpha-2 country code of the pickup address.

pickupLatnumber nullable

The pickup latitude coordinate.

pickupLngnumber nullable

The pickup longitude coordinate.

pickupPhoneNumberstring nullable

The phone number to contact at the pickup location in the form: '+15555555555'

pickupFirstNamestring nullable

First name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters.

pickupLastNamestring nullable

Last name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters.

pickupBusinessNamestring nullable

Pickup business name at the origin.

pickupInstructionsstring nullable

Any special instructions for pickup.

pickupStoreLocationIdstring nullable

A unique identifier for store location created in Nash.

pickupExternalStoreLocationIdstring nullable

The external identifier used for your store.

pickupZoneIdsstring[] nullable

A list of zone IDs to consider for the Order. The pickup store location will be selected later via selected delivery window.

pickupBarcodesstring[] nullable

Array containing barcode values that are required to be scanned at the pickup waypoint.

dropoffAddressstring nullable

The dropoff address of the order

dropoffPlaceIdstring nullable

Google place id for the dropoff location.

dropoffAddressNumberstring nullable

The number on a house.

dropoffAddressSecondarynumberstring nullable

Secondary number on an address e.g. an apartment building.

dropoffAddressFormattedStreetstring nullable

The street of the address.

dropoffAddressCitystring nullable

The city of the dropoff address.

dropoffAddressCountystring nullable

The county associated with the dropoff address.

dropoffAddressStatestring nullable

The state of the dropoff address.

dropoffAddressZipstring nullable

The zip or postal code of the dropoff address.

dropoffAddressCountrystring nullable

The ISO 3166-1 alpha-2 country code of the dropoff address.

dropoffLatnumber nullable

The dropoff latitude coordinate.

dropoffLngnumber nullable

The dropoff longitude coordinate.

dropoffPhoneNumberstring nullable

The phone number to contact at the dropoff location in the form: '+15555555555'

dropoffFirstNamestring nullable

First name of the contact at the destination.

dropoffLastNamestring nullable

Last name of the contact at the destination.

dropoffBusinessNamestring nullable

Dropoff business name at the destination.

dropoffInstructionsstring nullable

Any special instructions for dropoff.

dropoffStoreLocationIdstring nullable

A unique identifier for store location created in Nash.

dropoffBarcodesstring[] nullable

Array containing barcode values that are required to be scanned at the dropoff waypoint.

deliveryModestring nullable

The delivery mode of the order

pickupStartTimestring nullable

The start time of the pickup window.

pickupEndTimestring nullable

The end time of the pickup window.

dropoffStartTimestring nullable

The start time of the dropoff window.

dropoffEndTimestring nullable

The end time of the dropoff window.

descriptionstring nullable

The description of the order

itemsCountstring nullable

The number of items in the order

requirementsstring[] nullable

The requirements of the order

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']

currencystring nullable

The currency of the order

valueCentsstring nullable

The value of the order in cents

tipAmountCentsstring nullable

The tip amount of the order in cents

widthstring nullable

The width of the order in cm

depthstring nullable

The depth of the order in cm

heightstring nullable

The height of the order in cm

volumestring nullable

The volume of the order in cm^3

weightstring nullable

The weight of the order in kg

dispatchStrategyIdstring nullable

The dispatch strategy id (or option group id) to be associated with the order. Note: It is the best practice to allow automations to control dispatch strategy and not send the dispatch strategy id in the request.

maxDeliveryFeeCentsstring nullable

The max delivery fee of the order in cents

validationErrorsobject nullable

The validation errors of the order

failedQuotesstring[] nullable

The failed quotes of the order