Orders

User order retrieval and cancellation

List authenticated user's orders

get

Retrieves paginated list of orders for the authenticated user. Includes order items, discounts, addresses, and payment details.

For guest users, returns only the most recent order.

Supports filtering and search by order number.

Authorizations
sessionidstringRequired

Session cookie for authentication

Query parameters
last_monthbooleanOptional

Filter orders from last 30 days only

searchstringOptional

Search by order number

pageintegerOptional

Page number for pagination

Header parameters
CookiestringOptional

Session cookie in format sessionid=<value>. May use site-specific cookie name (e.g., osessionid).

Responses
chevron-right
200

List of orders

application/json
get
/users/orders/

Retrieve specific order details

get

Retrieves detailed information for a specific order. User can only access their own orders.

Guest User Behavior: For guest users, this endpoint ignores the pk parameter and always returns their most recent order (ordered by -pk, first result). This is because guest users are restricted to viewing only their latest order.

Access Control: Users cannot access orders belonging to other users. Attempting to access another user's order returns 404 Not Found.

Response Format:

  • JSON requests: Returns order data directly

  • HTML requests: Wraps response in {"data": {...}} format

Authorizations
sessionidstringRequired

Session cookie for authentication

Path parameters
pkintegerRequired

Order ID. Must belong to the authenticated user. For guest users, this parameter is ignored and the most recent order is returned instead.

Header parameters
CookiestringOptional

Session cookie in format sessionid=<value>. May use site-specific cookie name (e.g., osessionid).

Responses
chevron-right
200

Order details retrieved successfully

application/json
get
/users/orders/{pk}/

Retrieve order cancellation information

get

Retrieves order information relevant for cancellation. Typically used to display cancellation page/form.

Guest User Behavior: For guest users, this endpoint ignores the pk parameter and always returns their last order (ordered by -created_date, last result). This is because guest users are restricted to viewing only their most recent order for cancellation.

Access Control: Users can only access their own orders. Attempting to access another user's order returns 404 Not Found.

Response Format:

  • JSON requests: Returns order data directly

  • HTML requests: Wraps response in {"data": {...}} format

Authorizations
sessionidstringRequired

Session cookie for authentication

Path parameters
pkintegerRequired

Order ID. Must belong to the authenticated user. For guest users, this parameter is ignored and the last order (by created_date) is returned instead.

Header parameters
CookiestringOptional

Session cookie in format sessionid=<value>. May use site-specific cookie name (e.g., osessionid).

Responses
chevron-right
200

Order cancellation details retrieved successfully

application/json
get
/users/orders/{pk}/cancellation/

List archived/old orders

get

Retrieves paginated list of archived orders. These are typically migrated historical orders from legacy systems.

Guest User Access: Not available for guest users (returns empty list).

Filtering & Search:

  • Currency filter: Filter by currency type (e.g., ?currency=try or ?currency=usd)

  • Number search: Search by order number using search parameter

  • Custom ordering: Order by any field using sort parameter

Authorizations
sessionidstringRequired

Session cookie for authentication

Query parameters
currencystring · enumOptional

Filter orders by currency type

Possible values:
searchstringOptional

Search by order number

sortstringOptional

Field to order by. Use - prefix for descending order. Examples: created_date, -created_date, amount, -number Available fields: number, user_email, status, created_date, amount, discount_amount, currency, payment_type, bank, installment_count, tracking_number, shipping_company, shipping_address, billing_address

Example: -created_date
pageintegerOptional

Page number for pagination

Header parameters
CookiestringOptional

Session cookie in format sessionid=<value>. May use site-specific cookie name (e.g., osessionid).

Responses
chevron-right
200

List of old orders retrieved successfully

application/json
get
/users/old-orders/

Retrieve specific old order details

get

Retrieves detailed information for a specific archived order. User can only access their own orders.

Guest User Access: Not available for guest users, returns 404 Not Found for any pk value.

Access Control: Users cannot access orders belonging to other users. Attempting to access another user's order returns 404 Not Found.

Response Format:

  • JSON requests: Returns order data directly

  • HTML requests: Wraps response in {"data": {...}} format

Authorizations
sessionidstringRequired

Session cookie for authentication

Path parameters
pkintegerRequired

Old order ID. Must belong to the authenticated user. Guest users will always receive 404.

Header parameters
CookiestringOptional

Session cookie in format sessionid=<value>. May use site-specific cookie name (e.g., osessionid).

Responses
chevron-right
200

Old order details retrieved successfully

application/json
get
/users/old-orders/{pk}/

Last updated

Was this helpful?