AnonymousOrders

Guest/anonymous order operations

Query order by number and email (guest users)

post

Allows guest users to retrieve their order details by providing the order number and email address used during checkout.

Access Restriction: Only returns orders where user type is 'guest'. Orders from registered users cannot be queried through this endpoint.

Validation:

• Order must exist and belong to a guest user

• Email must exactly match the order's user_email field

• Email format must be valid

Response: Returns array with single order object if found.

Body

application/json

numberstringRequired

Order number

emailstring · emailRequired

Email address used for the order (must match)

Responses

200

Order details retrieved successfully

application/json

Array containing the matched order (always single item if successful)

pkintegerOptional

Order ID

numberstringOptional

Order number (unique identifier)

amountstringOptional

Order total amount

discount_amountstringOptional

Total discount applied

amount_without_discountstringOptional

Amount before discounts (computed field)

shipping_amountstringOptional

Shipping cost

shipping_tax_ratestring · nullableOptional

Tax rate for shipping

refund_amountstringOptional

Total refund amount

discount_refund_amountstringOptional

Refunded discount amount

shipping_refund_amountstringOptional

Refunded shipping amount

is_cancelledbooleanOptional

Whether order is fully cancelled

is_cancellablebooleanOptional

Whether order can be cancelled

is_refundablebooleanOptional

Whether order is eligible for refund

is_payablebooleanOptional

Whether order has pending payment

tracking_urlstring · nullableOptional

Shipment tracking URL

tracking_numberstring · nullableOptional

Shipment tracking number

invoice_numberstring · nullableOptional

Invoice number

invoice_datestring · nullableOptional

Invoice date

e_archive_urlstring · nullableOptional

E-Archive document URL

order_typeone ofOptional

Type of order. Possible values:

• regular: Standard order placed by customer
• addon: Additional items added to an existing order
• replacement: Replacement order for defective/incorrect items

Field can be null for legacy orders created before order_type was introduced.

or

nullOptional

user_emailstring · emailOptional

Email address used for order

has_gift_boxboolean · nullableOptional

Whether order includes gift box

gift_box_notestring · nullableOptional

Gift box message/note

notesstring · nullableOptional

Order delivery instructions

installment_countintegerOptional

Number of payment installments

installment_interest_amountstringOptional

Interest amount for installment payment

bin_numberstring · nullableOptional

Credit card BIN number (first 6-8 digits)

created_datestring · date-timeOptional

modified_datestring · date-timeOptional

shipping_companyone ofOptional

or

nullOptional

bankone ofOptional

Bank information (null if not credit card payment)

or

nullOptional

extra_fieldobject · nullableOptional

Additional order data (rewards, custom fields, etc.)

400

Validation errors:

• Order number doesn't exist or doesn't belong to a guest user
• Email doesn't match order's user_email
• Invalid email format

post

/users/orders/anonymous/

HTTPcURLJavaScriptPython

POST /users/orders/anonymous/ HTTP/1.1
Host: sandbox.akinon.com
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "number": "text",
  "email": "[email protected]"
}

[
  {
    "pk": 1,
    "number": "text",
    "status": {
      "value": "text",
      "label": "text"
    },
    "currency": {
      "value": "text",
      "label": "text"
    },
    "amount": "text",
    "discount_amount": "text",
    "amount_without_discount": "text",
    "shipping_amount": "text",
    "shipping_tax_rate": null,
    "refund_amount": "text",
    "discount_refund_amount": "text",
    "shipping_refund_amount": "text",
    "is_cancelled": true,
    "is_cancellable": true,
    "is_refundable": true,
    "is_payable": true,
    "tracking_url": null,
    "tracking_number": null,
    "invoice_number": null,
    "invoice_date": null,
    "e_archive_url": null,
    "order_type": {
      "value": "text",
      "label": "text"
    },
    "user_email": "[email protected]",
    "has_gift_box": null,
    "gift_box_note": null,
    "notes": null,
    "installment_count": 1,
    "installment_interest_amount": "text",
    "bin_number": null,
    "created_date": "2026-03-07T04:59:03.715Z",
    "modified_date": "2026-03-07T04:59:03.715Z",
    "shipping_address": {
      "pk": 1,
      "email": null,
      "phone_number": "text",
      "first_name": "text",
      "last_name": "text",
      "country": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "city": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "line": "text",
      "title": "text",
      "township": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "district": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "postcode": null,
      "notes": null,
      "company_name": null,
      "tax_office": null,
      "tax_no": null,
      "e_bill_taxpayer": null,
      "hash_data": "text",
      "address_type": {
        "value": "text",
        "label": "text"
      },
      "retail_store": {},
      "remote_id": null,
      "identity_number": null,
      "extra_field": null,
      "user": null,
      "is_corporate": null,
      "primary": null
    },
    "billing_address": {
      "pk": 1,
      "email": null,
      "phone_number": "text",
      "first_name": "text",
      "last_name": "text",
      "country": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "city": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "line": "text",
      "title": "text",
      "township": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "district": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "postcode": null,
      "notes": null,
      "company_name": null,
      "tax_office": null,
      "tax_no": null,
      "e_bill_taxpayer": null,
      "hash_data": "text",
      "address_type": {
        "value": "text",
        "label": "text"
      },
      "retail_store": {},
      "remote_id": null,
      "identity_number": null,
      "extra_field": null,
      "user": null,
      "is_corporate": null,
      "primary": null
    },
    "shipping_company": {
      "value": "text",
      "label": "text"
    },
    "client_type": {
      "value": "text",
      "label": "text"
    },
    "payment_option": {
      "pk": 1,
      "name": "text",
      "payment_type": "text",
      "slug": "text"
    },
    "bank": {
      "pk": 1,
      "name": "text",
      "slug": "text",
      "logo": null,
      "logo_path": null
    },
    "extra_field": null,
    "orderitem_set": [
      {
        "pk": 1,
        "product": {
          "pk": 1,
          "sku": "text",
          "base_code": "text",
          "name": "text",
          "image": null,
          "absolute_url": "text",
          "attributes": {},
          "attributes_kwargs": {},
          "form_schema": [],
          "data_source": null,
          "extra_attributes": {},
          "category": null,
          "attribute_set": []
        },
        "order": 1,
        "price": "text",
        "tax_rate": "text",
        "retail_price": null,
        "discount_amount": null,
        "discounted_price": "text",
        "status": {
          "value": "text",
          "label": "text"
        },
        "price_currency": {
          "value": "text",
          "label": "text"
        },
        "is_cancelled": true,
        "is_cancellable": true,
        "is_refundable": true,
        "is_tradable": true,
        "tracking_url": null,
        "tracking_number": null,
        "invoice_number": null,
        "invoice_date": null,
        "e_archive_url": null,
        "shipping_company": {
          "value": "text",
          "label": "text"
        },
        "shipping_option_group": {
          "pk": 1,
          "amount": "text",
          "shipping_option_name": "text",
          "shipping_option_logo": null
        },
        "estimated_delivery_date": null,
        "shipped_date": null,
        "delivered_date": null,
        "image": null,
        "attributes": null,
        "attributes_kwargs": null,
        "extra_field": null,
        "cancellationrequest_set": [
          {
            "pk": 1,
            "uuid": "123e4567-e89b-12d3-a456-426614174000",
            "order_item": 1,
            "reason": 1,
            "cancellation_type": {
              "value": "text",
              "label": "text"
            },
            "status": {
              "value": "text",
              "label": "text"
            },
            "description": null,
            "iban": null,
            "holder_name": null,
            "easy_return": {
              "shipping_company": {
                "value": "text",
                "label": "text"
              },
              "code": "text",
              "start_date": null,
              "end_date": null,
              "status": {
                "value": "text",
                "label": "text"
              },
              "tracking_number": null,
              "tracking_url": null,
              "pickup_date": {
                "date": "2026-03-07",
                "hour_range": {
                  "start": "text",
                  "end": "text"
                }
              }
            },
            "quantity": null,
            "fully_refund_as_loyalty_money": null,
            "cancellation_request_image_set": [
              {
                "pk": 1,
                "cancellation_request": 1,
                "image": "https://example.com",
                "description": null,
                "is_uploaded_by_user": true,
                "created_date": "2026-03-07T04:59:03.715Z",
                "modified_date": "2026-03-07T04:59:03.715Z"
              }
            ],
            "created_date": "2026-03-07T04:59:03.715Z",
            "modified_date": "2026-03-07T04:59:03.715Z"
          }
        ],
        "active_cancellation_request": {
          "pk": 1,
          "uuid": "123e4567-e89b-12d3-a456-426614174000",
          "order_item": 1,
          "reason": 1,
          "cancellation_type": {
            "value": "text",
            "label": "text"
          },
          "status": {
            "value": "text",
            "label": "text"
          },
          "description": null,
          "iban": null,
          "holder_name": null,
          "easy_return": {
            "shipping_company": {
              "value": "text",
              "label": "text"
            },
            "code": "text",
            "start_date": null,
            "end_date": null,
            "status": {
              "value": "text",
              "label": "text"
            },
            "tracking_number": null,
            "tracking_url": null,
            "pickup_date": {
              "date": "2026-03-07",
              "hour_range": {
                "start": "text",
                "end": "text"
              }
            }
          },
          "quantity": null,
          "fully_refund_as_loyalty_money": null,
          "cancellation_request_image_set": [
            {
              "pk": 1,
              "cancellation_request": 1,
              "image": "https://example.com",
              "description": null,
              "is_uploaded_by_user": true,
              "created_date": "2026-03-07T04:59:03.715Z",
              "modified_date": "2026-03-07T04:59:03.715Z"
            }
          ],
          "created_date": "2026-03-07T04:59:03.715Z",
          "modified_date": "2026-03-07T04:59:03.715Z"
        },
        "available_easy_return_shipping_companies": [
          {
            "pk": 1,
            "shipping_company": {
              "value": "text",
              "label": "text"
            },
            "name": "text"
          }
        ],
        "datasource_detailed": null,
        "extra_product_stock_detailed": null,
        "extra_product_price_detailed": null
      }
    ],
    "discountitem_set": [
      {
        "name": "text",
        "amount": "text",
        "created_date": "2026-03-07T04:59:03.715Z",
        "order_number": "text",
        "currency": {
          "value": "text",
          "label": "text"
        }
      }
    ],
    "loyaltytransaction_set": [
      {
        "pk": 1,
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "amount": "text",
        "order": null,
        "user": null,
        "user_email": null,
        "reference": null
      }
    ]
  }
]

Create cancellation request for guest order

post

Allows guest users to request cancellation of order items. Requires order number and email for verification.

Validation:

• Order must exist and belong to a guest user

• Email must match order's user_email

• Order item must belong to the specified order

• Order item cannot already have an active cancellation request

Cancellation Types:

• cancel: Simple cancellation without refund process

• refund: Refund request (requires shipping_company for easy return)

Shipping Company Requirement: For refund type cancellations, shipping_company is required for easy return process.

Error Codes:

• cancellation_request_100_1: Cancellation request already exists for this order item

Body

application/json

numberstringRequired

Order number

emailstring · emailRequired

Email address (must match order)

order_itemintegerRequired

Order item ID to cancel

reasonintegerRequired

Cancellation reason ID

cancellation_typestring · enumRequired

Type of cancellation.

• cancel: Simple cancellation
• refund: Cancellation with refund (easy return)

Possible values:

descriptionstringOptional

Optional cancellation description

shipping_companyintegerOptional

Easy return shipping company ID (required for refund type). Must be an active EasyReturnShippingCompany.

quantityinteger · min: 1Optional

Quantity to cancel (for mergeable order items). Cannot exceed order item quantity.

ibanstring · max: 34Optional

IBAN for refund (for cash payment orders)

holder_namestring · max: 255Optional

Account holder name for refund

Responses

201

Cancellation request created successfully

application/json

400

Validation errors:

• Order not found or doesn't belong to guest user
• Email doesn't match order
• Order item doesn't exist or doesn't belong to order
• Cancellation request already exists (error_code: cancellation_request_100_1)
• Missing required fields for refund type
• Invalid quantity (exceeds order item quantity for mergeable items)

post

/users/orders/anonymous/cancellation_requests/

HTTPcURLJavaScriptPython

POST /users/orders/anonymous/cancellation_requests/ HTTP/1.1
Host: sandbox.akinon.com
Content-Type: application/json
Accept: */*
Content-Length: 503

{
  "number": "text",
  "email": "[email protected]",
  "order_item": 1,
  "reason": 1,
  "cancellation_type": "cancel",
  "description": "text",
  "shipping_company": 1,
  "pickup_date": {
    "date": "2024-12-25",
    "hour_range": {
      "start": "09:00",
      "end": "12:00"
    }
  },
  "quantity": 1,
  "iban": "text",
  "holder_name": "text",
  "cancellation_request_image_set": [
    {
      "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/...",
      "description": "Product damage on corner"
    }
  ]
}

{
  "pk": 1,
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "order_item": 1,
  "reason": 1,
  "cancellation_type": {
    "value": "text",
    "label": "text"
  },
  "status": {
    "value": "text",
    "label": "text"
  },
  "description": null,
  "iban": null,
  "holder_name": null,
  "easy_return": {
    "shipping_company": {
      "value": "text",
      "label": "text"
    },
    "code": "text",
    "start_date": null,
    "end_date": null,
    "status": {
      "value": "text",
      "label": "text"
    },
    "tracking_number": null,
    "tracking_url": null,
    "pickup_date": {
      "date": "2026-03-07",
      "hour_range": {
        "start": "text",
        "end": "text"
      }
    }
  },
  "quantity": null,
  "fully_refund_as_loyalty_money": null,
  "cancellation_request_image_set": [
    {
      "pk": 1,
      "cancellation_request": 1,
      "image": "https://example.com",
      "description": null,
      "is_uploaded_by_user": true,
      "created_date": "2026-03-07T04:59:03.715Z",
      "modified_date": "2026-03-07T04:59:03.715Z"
    }
  ],
  "created_date": "2026-03-07T04:59:03.715Z",
  "modified_date": "2026-03-07T04:59:03.715Z"
}

Create bulk cancellation requests for guest order

post

Allows guest users to request cancellation of multiple order items in a single request. Requires order number and email for verification.

Validation:

• Order must exist and belong to a guest user

• Email must match order's user_email

• All order items must belong to the specified order

• At least one order item must be provided

• Order items cannot already have active cancellation requests

Structure: Request contains array of cancel_order_items, where each item can have:

• Required: order_item, reason, cancellation_type

• Optional: description, shipping_company, pickup_date, quantity, cancellation_request_image_set

Pickup Address: Optional shared pickup address for all items (for easy return refunds).

Loyalty Money Refund: Set fully_refund_as_loyalty_money to refund entire amount as loyalty points.

Body

application/json

numberstringRequired

Order number

emailstring · emailRequired

Email address (must match order)

pickup_addressintegerOptional

Optional shared pickup address ID for all items. Must be a customer address belonging to the user.

fully_refund_as_loyalty_moneybooleanOptional

Whether to refund entire amount as loyalty points

Default: false

Responses

201

Cancellation requests created successfully for all items

application/json

400

Validation errors:

• Order not found or doesn't belong to guest user
• Email doesn't match order
• Empty cancel_order_items array
• Order item doesn't exist or doesn't belong to order
• Missing required fields (order_item, reason, cancellation_type)
• Invalid quantity for mergeable items
• Too many images per item (exceeds CANCELLATION_REQUEST_MAX_IMAGE_COUNT_PER_ORDER_ITEM)

post

/users/orders/anonymous/bulk_cancellation_requests/

HTTPcURLJavaScriptPython

POST /users/orders/anonymous/bulk_cancellation_requests/ HTTP/1.1
Host: sandbox.akinon.com
Content-Type: application/json
Accept: */*
Content-Length: 459

{
  "number": "text",
  "email": "[email protected]",
  "cancel_order_items": [
    {
      "order_item": 1,
      "reason": 1,
      "cancellation_type": "cancel",
      "description": "text",
      "shipping_company": 1,
      "pickup_date": {
        "date": "2024-12-25",
        "hour_range": {
          "start": "09:00",
          "end": "12:00"
        }
      },
      "quantity": 1,
      "iban": "text",
      "holder_name": "text",
      "cancellation_request_image_set": [
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
          "description": "text"
        }
      ]
    }
  ],
  "pickup_address": 1,
  "fully_refund_as_loyalty_money": false
}

[
  {
    "pk": 1,
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "order_item": 1,
    "reason": 1,
    "cancellation_type": {
      "value": "text",
      "label": "text"
    },
    "status": {
      "value": "text",
      "label": "text"
    },
    "description": null,
    "iban": null,
    "holder_name": null,
    "easy_return": {
      "shipping_company": {
        "value": "text",
        "label": "text"
      },
      "code": "text",
      "start_date": null,
      "end_date": null,
      "status": {
        "value": "text",
        "label": "text"
      },
      "tracking_number": null,
      "tracking_url": null,
      "pickup_date": {
        "date": "2026-03-07",
        "hour_range": {
          "start": "text",
          "end": "text"
        }
      }
    },
    "quantity": null,
    "fully_refund_as_loyalty_money": null,
    "cancellation_request_image_set": [
      {
        "pk": 1,
        "cancellation_request": 1,
        "image": "https://example.com",
        "description": null,
        "is_uploaded_by_user": true,
        "created_date": "2026-03-07T04:59:03.715Z",
        "modified_date": "2026-03-07T04:59:03.715Z"
      }
    ],
    "created_date": "2026-03-07T04:59:03.715Z",
    "modified_date": "2026-03-07T04:59:03.715Z"
  }
]