v1

latestSwagger 2.0BeezUP2026-07-13254876845.8 KB
Marketplaces - Orders - List

[DEPRECATED] Get a paginated list of all Orders without details

Use /orders/v3 instead

post/v2/user/marketplaces/orders/list/light

Request body

marketplaceTechnicalCodesBeezUPCommonMarketplaceTechnicalCode[]
marketplaceBusinessCodesBeezUPCommonMarketplaceBusinessCode[]
accountIdsAccountId[]

Account Id list

storeIdsBeezUPCommonStoreId[]

Store Id list

beezUPOrderStatusesBeezUPOrderStatus[]
dateSearchType'Modification' | 'Purchase' | 'MarketPlaceModification'

Indicates on which date you want to make the filter

beginPeriodUtcDatestring date-time required

The begin period you want to make the search.
The period MUST not be greater than 62 days. The begin period MUST be lower than the end period.

endPeriodUtcDatestring date-time required

The end period of you search.
The period MUST not be greater than 62 days.
The end period MUST be greater than the begin period. The end period MUST be lower to the current date.

invoiceAvailabilityTypestring

Indicates on which invoice availability to filter

order_Buyer_Namestring

Buyer full name

marketplaceOrderIdsMarketplaceOrderId[]
orderMerchantInfoSynchronizationStatusstring

Indicates on which order merchant info synchronization status to filter

order_MerchantOrderIdsOrderMerchantOrderId[]

Merchant order id list

pageSizeinteger required

Indicate the order count per page

pageNumberinteger required

Indicates the page number

Example request

{
  "marketplaceTechnicalCodes": [
    "PriceMinister"
  ],
  "marketplaceBusinessCodes": [
    "PRICEMINISTER"
  ],
  "accountIds": [
    "12345"
  ],
  "storeIds": [
    "64f43358-63a1-47f7-97ec-0301fc39956b"
  ],
  "beezUPOrderStatuses": [
    "InProgress"
  ],
  "beginPeriodUtcDate": "2017-03-01T13:10:01Z",
  "endPeriodUtcDate": "2017-04-01T13:10:01Z",
  "invoiceAvailabilityType": "All",
  "order_Buyer_Name": "Monroe",
  "marketplaceOrderIds": [
    "AmazonOrderId1234"
  ],
  "orderMerchantInfoSynchronizationStatus": "All",
  "order_MerchantOrderIds": [
    "MyOrderId1234"
  ]
}

Response

Successfully fetched the list of Orders

Example response

{
  "paginationResult": {
    "entryCount": "25",
    "pageCount": "38",
    "totalEntryCount": "943",
    "links": {
      "first": {
        "href": "/v2/user/marketplaces/orders/list/full",
        "method": "POST",
        "parameters": [
          {
            "name": "request",
            "in": "body",
            "type": "object",
            "schema": "orderListRequest",
            "value": {
              "beginPeriodUtcDate": "2014-08-25T07:32:31.584Z",
              "endPeriodUtcDate": "2014-09-24T07:32:31.584Z",
              "pageSize": "25",
              "pageNumber": "1"
            }
          }
        ]
      },
      "last": {
        "href": "/v2/user/marketplaces/orders/list/full",
        "method": "POST",
        "parameters": [
          {
            "name": "request",
            "in": "body",
            "type": "object",
            "schema": "orderListRequest",
            "value": {
              "beginPeriodUtcDate": "2014-08-25T07:32:31.584Z",
              "endPeriodUtcDate": "2014-09-24T07:32:31.584Z",
              "pageSize": "25",
              "pageNumber": "38"
            }
          }
        ]
      },
      "next": {
        "href": "/v2/user/marketplaces/orders/list/full",
        "method": "POST",
        "parameters": [
          {
            "name": "request",
            "in": "body",
            "type": "object",
            "schema": "orderListRequest",
            "value": {
              "beginPeriodUtcDate": "2014-08-25T07:32:31.584Z",
              "endPeriodUtcDate": "2014-09-24T07:32:31.584Z",
              "pageSize": "25",
              "pageNumber": "2"
            }
          }
        ]
      }
    }
  },
  "orders": [
    {
      "marketplaceTechnicalCode": "Amazon",
      "beezUPOrderId": "00000000000000000000000000000000000000000000000",
      "beezUPOrderUrl": "http://www.mydomain.com",
      "marketplaceBusinessCode": "GOSPORT",
      "order_MarketplaceOrderId": "AMAZON12345",
      "order_Status_BeezUPOrderStatus": "Shipped",
      "order_Status_MarketplaceOrderStatus": "In_progress_3",
      "order_MerchantOrderId": "MyOrderMerchantId",
      "order_MerchantECommerceSoftwareName": "Prestashop",
      "order_MerchantECommerceSoftwareVersion": "123.0.1",
      "order_PurchaseUtcDate": "2017-03-31T21:30:23Z",
      "order_LastModificationUtcDate": "2017-04-16T10:30:23Z",
      "order_MarketplaceLastModificationUtcDate": "2017-04-16T10:25:23Z",
      "order_Buyer_Name": "Monroe",
      "order_CurrencyCode": "EUR",
      "etag": "\"ca071a4580129f932a03971968ffef69\"",
      "links": {
        "self": {
          "href": "/v2/user/marketplaces/orders/Amazon/1001/00000000000000000000000000000000000000000000000",
          "method": "GET"
        }
      }
    }
  ],
  "links": {
    "harvest": {
      "href": "/v2/user/marketplaces/orders/harvest",
      "method": "POST"
    },
    "setMerchantInfos": {
      "href": "/v2/user/marketplaces/orders/setMerchantOrderInfos",
      "method": "POST",
      "parameters": {
        "request": {
          "in": "body",
          "required": true,
          "type": "object",
          "schema": "setMerchantOrderInfoRequest"
        }
      }
    },
    "clearMerchantInfos": {
      "href": "/v2/user/marketplaces/orders/clearMerchantOrderInfos",
      "method": "POST"
    },
    "export": {
      "href": "/v2/user/marketplaces/orders/exportations",
      "method": "POST",
      "properties": {
        "request": {
          "in": "body",
          "required": true,
          "type": "object",
          "schema": "exportOrderListRequest"
        }
      }
    },
    "status": {
      "href": "/v2/user/marketplaces/orders/status",
      "method": "GET"
    },
    "self": {
      "href": "/v2/user/marketplaces/orders/list/light",
      "method": "POST",
      "properties": {
        "request": {
          "in": "body",
          "required": false,
          "type": "object",
          "schema": "orderListRequest"
        }
      }
    }
  }
}