GET orders/:actor/:status[/:start]

Returns a collection of orders specified by the actor parameter (buyer or seller) and the status parameter (bought, paid, sent, received, lost, cancelled). Only orders for the authenticated user are returned. Returns 206 Partial Content, if the resulting collection contains more than 100 orders. A starting product can be specified by the optional start parameter.

Resource Information

Authentication	Required
Response Format	XML
HTTP Methods	GET
Response Object	Order
API Version	1.0

Resource URL

https://www.mkmapi.eu/ws/:user/:apikey/orders/:actor/:status[/:start]

Parameters

actor	Mandatory

• Specifies if orders are returned where you're:
  • 1 - the seller
  • 2 - the buyer
• Example Value: 1

status	Mandatory

• Specifies if orders are returned with the following status:
  • 1 - bought
  • 2 - paid
  • 4 - sent
  • 8 - received
  • 32 - lost
  • 128 - cancelled
• Example Value: 4

start	Optional

• Specifies the starting number of orders being returned.
• Example Value: 101

Example Request

GET https://www.mkmapi.eu/ws/someuser/someapikey/orders/1/4/101