v1

latestOpenAPI 3.0.32026-08-06150495.9 KB
Orders API

Get Orders

The endpoint retrieves a list of orders based on the provided query parameters. The request includes a limit, offset, and clientId to filter the results. Additionally, the request payload includes a start date, end date, listing IDs, and channel to further refine the search.

Response

The response for this request is a JSON object with the following structure:

{
  "status": boolean,
  "statusCode": integer,
  "message": string,
  "result": {
    "total": integer,
    "orders": [
      {
        "orderId": string,
        "ListingId": string,
        "CustomerId": string,
        "channel": string,
        "customerIsPass": integer,
        "commisionPercentage": integer,
        "deliveryUUID": string,
        "orderUUID": string,
        "isPickupOrder": integer,
        "orderConfirmationTime": string,
        "orderAcceptedPosTime": string,
        "orderBeginTripTime": string,
        "orderCreationTime": string,
        "orderCompletionTime": string,
        "orderMerchantCommisson": integer,
        "orderRequestTime": string,
        "orderTax": integer,
        "orderTotalAfterDiscount": integer,
        "orderSubTotal": integer,
        "orderMerchantTax": integer,
        "orderFulfillmentMode": string,
        "orderMarketingFee": integer,
        "orderStatus": string,
        "orderNetPayout": integer,
        "taxPercentage": integer,
        "orderErrorCharges": integer,
        "orderErrors": string,
        "errorChargeExcludingTax": integer,
        "errorChargeTax": integer,
        "adjustmentExcludingTax": integer,
        "adjustmentTax": integer,
        "adsFee": integer,
        "alcoholFeeTax": integer,
        "alcoholFlatFee": integer,
        "offerTitle": string,
        "riderFirstName": string,
        "riderLastName": string,
        "preOrderMerchantTip": integer,
        "orderMerchantTip": integer,
        "giftCardCredit": integer,
        "loyaltyPoints": integer,
        "orderFailureReason": string,
        "orderMissingItems": string,
        "orderMerchantDelivery": string,
        "orderNetSubTotal": integer,
        "orderRefunds": integer,
        "orderStorePayment": integer,
        "orderTotalFees": integer,
        "promoSpendOnFood": integer,
        "createdAt": string,
        "updatedAt": string,
        "channelBy": string,
        "orderStatusDetails": string,
        "customerName": string,
        "customerFullName": string,
        "restaurantName": string,
        "restaurantAddress": string,
        "restaurantId": string,
        "restaurantCountryCode": string,
        "quotedDeliveryTime": string,
        "paymentMethod": string,
        "doordashDriveId": string,
        "driveDasherPreTip": integer,
        "deliveryFee": integer,
        "deliveryVariance": integer,
        "itemCount": integer,
        "bagFeeTotal": integer,
        "gst": integer,
        "gstOnAbBagFee": integer,
        "gstOnAbVariableServiceFee": integer,
        "hst": integer,
        "hstOnVariableServiceFeeTotal": integer,
        "timezone": string,
        "variableServiceFeeTotal": integer,
        "ezRewards": integer,
        "paymentTransactionFee": integer,
        "taxRemittedToState": integer,
        "otherPayments": integer,
        "preferredPartnerProgram": string
      }
    ]
  },
  "error": string
}
get/orders

Query parameters

limitstring
Example:5

(optional) – Specifies the number of clients to fetch. If not provided, the default value is 5.

offsetstring
Example:0

(optional) – Specifies the starting point for fetching the records. Used for pagination. The default value is 0.

clientIdstring
Example:604517c0-fae8-41b7-8c20-0fe4778e415c

(required) – The common ID between Voosh and the partner, used to identify the client.

Headers

access-tokenstring
Example:{{access-token}}

(required) – The unique token ID provided to the partner for authentication and secure data access.

Request body

channelstring[]
endDatestring
listingIdsstring[]
startDatestring

Example request

{
  "channel": [
    "DOORDASH",
    "DOORDASH_DRIVE"
  ],
  "endDate": "2024-08-14",
  "listingIds": [
    "P8521",
    "P8531"
  ],
  "startDate": "2024-07-15"
}

Response

200

{"stackTrail":"paths:/orders:get:responses:200:content:application/json:schema:properties:error","oasType":"schema","type":"unknown","example":null,"nullable":true}
messagestring
statusboolean
statusCodenumber

Example response

{
  "message": "Dispute manager orders fetched successfully",
  "result": {
    "orders": [
      {
        "CustomerId": "1246527420",
        "ListingId": "P8521",
        "adjustmentExcludingTax": null,
        "adjustmentTax": null,
        "adsFee": -4.56,
        "alcoholFeeTax": 0,
        "alcoholFlatFee": 0,
        "bagFeeTotal": null,
        "channel": "DOORDASH",
        "channelBy": "doordash",
        "commisionPercentage": 17,
        "createdAt": "2024-03-26 00:00:00",
        "customerFullName": "",
        "customerIsPass": 0,
        "customerName": "Payton W",
        "deliveryFee": null,
        "deliveryUUID": "fff73b0a-2fb8-3001-b9fc-eb3e2c10ada8",
        "deliveryVariance": null,
        "doordashDriveId": null,
        "driveDasherPreTip": null,
        "errorChargeExcludingTax": null,
        "errorChargeTax": null,
        "ezRewards": null,
        "giftCardCredit": 0,
        "gst": null,
        "gstOnAbBagFee": null,
        "gstOnAbVariableServiceFee": null,
        "hst": null,
        "hstOnVariableServiceFeeTotal": null,
        "isPickupOrder": 0,
        "itemCount": null,
        "loyaltyPoints": 0,
        "offerTitle": null,
        "orderAcceptedPosTime": null,
        "orderBeginTripTime": "2024-03-24 08:10:43",
        "orderCompletionTime": "2024-03-24 08:35:16",
        "orderConfirmationTime": "2024-03-24 08:00:11",
        "orderCreationTime": "2024-03-24 08:39:47",
        "orderErrorCharges": 0,
        "orderErrors": "[]",
        "orderFailureReason": null,
        "orderFulfillmentMode": null,
        "orderId": "2c10ada8",
        "orderMarketingFee": null,
        "orderMerchantCommisson": 5.32,
        "orderMerchantDelivery": null,
        "orderMerchantTax": 0,
        "orderMerchantTip": 0,
        "orderMissingItems": null,
        "orderNetPayout": 21.4,
        "orderNetSubTotal": 31.28,
        "orderRefunds": 0,
        "orderRequestTime": null,
        "orderStatus": "DELIVERED_ORDER",
        "orderStatusDetails": "{\"value\":\"DELIVERED_ORDER\",\"display\":\"Delivered\",\"descriptionDisplay\":\"The order was delivered at 8:35 AM on March 24, 2024.\"}",
        "orderStorePayment": -4.56,
        "orderSubTotal": 31.28,
        "orderTax": 1.87,
        "orderTotalAfterDiscount": null,
        "orderTotalFees": 0,
        "orderUUID": null,
        "otherPayments": null,
        "paymentMethod": null,
        "paymentTransactionFee": null,
        "preOrderMerchantTip": 0,
        "preferredPartnerProgram": null,
        "promoSpendOnFood": null,
        "quotedDeliveryTime": null,
        "restaurantAddress": "401 S Broad St, Lansdale, PA 19446, USA",
        "restaurantCountryCode": null,
        "restaurantId": "637944",
        "restaurantName": "Manhattan Bagel (Broad St.)",
        "riderFirstName": "Manpreet",
        "riderLastName": null,
        "taxPercentage": 6,
        "taxRemittedToState": null,
        "timezone": null,
        "updatedAt": "2024-03-26 00:00:00",
        "variableServiceFeeTotal": null
      },
      {
        "CustomerId": null,
        "ListingId": "P8321",
        "adjustmentExcludingTax": null,
        "adjustmentTax": null,
        "adsFee": null,
        "alcoholFeeTax": null,
        "alcoholFlatFee": null,
        "bagFeeTotal": null,
        "channel": "GRUBHUB",
        "channelBy": "Marketplace",
        "commisionPercentage": null,
        "createdAt": "2024-03-26 00:00:00",
        "customerFullName": null,
        "customerIsPass": 0,
        "customerName": null,
        "deliveryFee": null,
        "deliveryUUID": "ffea8f12-0993-11f0-8f13-51e996f7a725",
        "deliveryVariance": null,
        "doordashDriveId": null,
        "driveDasherPreTip": null,
        "errorChargeExcludingTax": null,
        "errorChargeTax": null,
        "ezRewards": null,
        "giftCardCredit": null,
        "gst": null,
        "gstOnAbBagFee": null,
        "gstOnAbVariableServiceFee": null,
        "hst": null,
        "hstOnVariableServiceFeeTotal": null,
        "isPickupOrder": null,
        "itemCount": null,
        "loyaltyPoints": null,
        "offerTitle": null,
        "orderAcceptedPosTime": "2024-03-25 12:13:20",
        "orderBeginTripTime": null,
        "orderCompletionTime": null,
        "orderConfirmationTime": "2024-03-25 12:13:06",
        "orderCreationTime": "2024-03-25 12:13:04",
        "orderErrorCharges": null,
        "orderErrors": null,
        "orderFailureReason": null,
        "orderFulfillmentMode": "Self Delivery",
        "orderId": "589329324433213",
        "orderMarketingFee": 0,
        "orderMerchantCommisson": -0.95,
        "orderMerchantDelivery": 0,
        "orderMerchantTax": 0,
        "orderMerchantTip": 257,
        "orderMissingItems": "0",
        "orderNetPayout": 22.28,
        "orderNetSubTotal": null,
        "orderRefunds": null,
        "orderRequestTime": "2024-03-25 12:13:04",
        "orderStatus": "confirmed",
        "orderStatusDetails": null,
        "orderStorePayment": null,
        "orderSubTotal": 14.99,
        "orderTax": 1.68,
        "orderTotalAfterDiscount": 14.99,
        "orderTotalFees": null,
        "orderUUID": "ffea8f10-0993-11f0-8f11-51e996f7a725",
        "otherPayments": null,
        "paymentMethod": null,
        "paymentTransactionFee": null,
        "preOrderMerchantTip": null,
        "preferredPartnerProgram": null,
        "promoSpendOnFood": "0",
        "quotedDeliveryTime": null,
        "restaurantAddress": null,
        "restaurantCountryCode": "US",
        "restaurantId": "288843",
        "restaurantName": null,
        "riderFirstName": null,
        "riderLastName": null,
        "taxPercentage": null,
        "taxRemittedToState": null,
        "timezone": null,
        "updatedAt": "2024-03-26 00:00:00",
        "variableServiceFeeTotal": null
      },
      {
        "CustomerId": "1125900065097928",
        "ListingId": "P8521",
        "adjustmentExcludingTax": null,
        "adjustmentTax": null,
        "adsFee": null,
        "alcoholFeeTax": null,
        "alcoholFlatFee": null,
        "bagFeeTotal": null,
        "channel": "DOORDASH_DRIVE",
        "channelBy": "drive",
        "commisionPercentage": 0,
        "createdAt": "2024-03-26 00:00:00",
        "customerFullName": "Sarah Dunn",
        "customerIsPass": 0,
        "customerName": "Sarah D",
        "deliveryFee": 6,
        "deliveryUUID": "ffe71c80-1ac7-3001-8ca5-b721cf1d7d6e",
        "deliveryVariance": -1257,
        "doordashDriveId": "2461320140",
        "driveDasherPreTip": 5,
        "errorChargeExcludingTax": null,
        "errorChargeTax": null,
        "ezRewards": null,
        "giftCardCredit": null,
        "gst": null,
        "gstOnAbBagFee": null,
        "gstOnAbVariableServiceFee": null,
        "hst": null,
        "hstOnVariableServiceFeeTotal": null,
        "isPickupOrder": 0,
        "itemCount": 5,
        "loyaltyPoints": null,
        "offerTitle": null,
        "orderAcceptedPosTime": null,
        "orderBeginTripTime": "2024-03-08 16:59:37",
        "orderCompletionTime": "2024-03-08 17:09:39",
        "orderConfirmationTime": null,
        "orderCreationTime": "2024-03-08 17:30:36",
        "orderErrorCharges": 0,
        "orderErrors": "[]",
        "orderFailureReason": null,
        "orderFulfillmentMode": null,
        "orderId": "0035 Dunn",
        "orderMarketingFee": null,
        "orderMerchantCommisson": 6,
        "orderMerchantDelivery": null,
        "orderMerchantTax": 0,
        "orderMerchantTip": 0,
        "orderMissingItems": null,
        "orderNetPayout": 0,
        "orderNetSubTotal": 22.47,
        "orderRefunds": 0,
        "orderRequestTime": null,
        "orderStatus": "DELIVERED_ORDER",
        "orderStatusDetails": "{\"value\":\"DELIVERED_ORDER\",\"display\":\"Delivered\",\"descriptionDisplay\":\"The order was delivered at 5:09 PM on March 8, 2024.\"}",
        "orderStorePayment": null,
        "orderSubTotal": 22.47,
        "orderTax": 0,
        "orderTotalAfterDiscount": null,
        "orderTotalFees": 11,
        "orderUUID": null,
        "otherPayments": null,
        "paymentMethod": "INVOICE",
        "paymentTransactionFee": null,
        "preOrderMerchantTip": 0,
        "preferredPartnerProgram": null,
        "promoSpendOnFood": null,
        "quotedDeliveryTime": "2024-03-08 17:30:36",
        "restaurantAddress": "1211 N Elmhurst Rd, Prospect Heights IL 60070-1029, United States",
        "restaurantCountryCode": null,
        "restaurantId": "23041854",
        "restaurantName": "Papa Johns DDD (3456)",
        "riderFirstName": "Dmitrii",
        "riderLastName": null,
        "taxPercentage": 0,
        "taxRemittedToState": null,
        "timezone": null,
        "updatedAt": "2024-03-26 00:00:00",
        "variableServiceFeeTotal": null
      },
      {
        "CustomerId": "1188490602",
        "ListingId": "P8521",
        "adjustmentExcludingTax": null,
        "adjustmentTax": null,
        "adsFee": -10.84,
        "alcoholFeeTax": 0,
        "alcoholFlatFee": 0,
        "bagFeeTotal": null,
        "channel": "DOORDASH",
        "channelBy": "doordash",
        "commisionPercentage": 10,
        "createdAt": "2024-03-26 00:00:00",
        "customerFullName": "",
        "customerIsPass": 0,
        "customerName": "Brianna R",
        "deliveryFee": null,
        "deliveryUUID": "ffe5d381-a458-3001-8490-d59f84da8edd",
        "deliveryVariance": null,
        "doordashDriveId": null,
        "driveDasherPreTip": null,
        "errorChargeExcludingTax": null,
        "errorChargeTax": null,
        "ezRewards": null,
        "giftCardCredit": 0,
        "gst": null,
        "gstOnAbBagFee": null,
        "gstOnAbVariableServiceFee": null,
        "hst": null,
        "hstOnVariableServiceFeeTotal": null,
        "isPickupOrder": 0,
        "itemCount": null,
        "loyaltyPoints": 0,
        "offerTitle": null,
        "orderAcceptedPosTime": null,
        "orderBeginTripTime": "2024-03-24 13:30:30",
        "orderCompletionTime": "2024-03-24 13:49:47",
        "orderConfirmationTime": "2024-03-24 13:18:30",
        "orderCreationTime": "2024-03-24 14:03:33",
        "orderErrorCharges": 0,
        "orderErrors": "[]",
        "orderFailureReason": null,
        "orderFulfillmentMode": null,
        "orderId": "84da8edd",
        "orderMarketingFee": null,
        "orderMerchantCommisson": 1.01,
        "orderMerchantDelivery": null,
        "orderMerchantTax": 0,
        "orderMerchantTip": 0,
        "orderMissingItems": null,
        "orderNetPayout": -1.75,
        "orderNetSubTotal": 10.1,
        "orderRefunds": 0,
        "orderRequestTime": null,
        "orderStatus": "DELIVERED_ORDER",
        "orderStatusDetails": "{\"value\":\"DELIVERED_ORDER\",\"display\":\"Delivered\",\"descriptionDisplay\":\"The order was delivered at 1:49 PM on March 24, 2024.\"}",
        "orderStorePayment": -10.84,
        "orderSubTotal": 10.1,
        "orderTax": 0.66,
        "orderTotalAfterDiscount": null,
        "orderTotalFees": 0,
        "orderUUID": null,
        "otherPayments": null,
        "paymentMethod": null,
        "paymentTransactionFee": null,
        "preOrderMerchantTip": 0,
        "preferredPartnerProgram": null,
        "promoSpendOnFood": null,
        "quotedDeliveryTime": null,
        "restaurantAddress": "1519 W Swann Ave, Tampa, FL 33606, USA",
        "restaurantCountryCode": null,
        "restaurantId": "25656855",
        "restaurantName": "The Salty Donut (Hyde Park Village)",
        "riderFirstName": "Roger",
        "riderLastName": null,
        "taxPercentage": 6.5,
        "taxRemittedToState": null,
        "timezone": null,
        "updatedAt": "2024-03-26 00:00:00",
        "variableServiceFeeTotal": null
      }
    ],
    "total": 897
  },
  "status": true,
  "statusCode": 200
}