Anonymous Orders

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

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

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

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/

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

{
  "number": "text",
  "email": "name@gmail.com"
}

[
  {
    "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": "name@gmail.com",
    "has_gift_box": null,
    "gift_box_note": null,
    "notes": null,
    "installment_count": 1,
    "installment_interest_amount": "text",
    "bin_number": null,
    "created_date": "2026-07-11T07:29:19.857Z",
    "modified_date": "2026-07-11T07:29:19.857Z",
    "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-07-11",
                "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-07-11T07:29:19.857Z",
                "modified_date": "2026-07-11T07:29:19.857Z"
              }
            ],
            "created_date": "2026-07-11T07:29:19.857Z",
            "modified_date": "2026-07-11T07:29:19.857Z"
          }
        ],
        "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-07-11",
              "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-07-11T07:29:19.857Z",
              "modified_date": "2026-07-11T07:29:19.857Z"
            }
          ],
          "created_date": "2026-07-11T07:29:19.857Z",
          "modified_date": "2026-07-11T07:29:19.857Z"
        },
        "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-07-11T07:29:19.857Z",
        "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

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

Cancellation request record (response)

pkintegerOptional

uuidstring · uuidOptional

Unique identifier for the cancellation request

order_itemintegerOptional

Order item ID

reasonintegerOptional

Cancellation reason ID

descriptionstring · nullableOptional

User-provided cancellation description

ibanstring · nullableOptional

IBAN for refund (for cash payment orders)

holder_namestring · nullableOptional

Account holder name for refund

quantityinteger · nullableOptional

Quantity being cancelled (for mergeable order items)

fully_refund_as_loyalty_moneyboolean · nullableOptional

Whether refund is issued as loyalty points

created_datestring · date-timeOptional

modified_datestring · date-timeOptional

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/

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

{
  "number": "text",
  "email": "name@gmail.com",
  "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-07-11",
      "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-07-11T07:29:19.857Z",
      "modified_date": "2026-07-11T07:29:19.857Z"
    }
  ],
  "created_date": "2026-07-11T07:29:19.857Z",
  "modified_date": "2026-07-11T07:29:19.857Z"
}

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

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

Array of created cancellation requests

pkintegerOptional

uuidstring · uuidOptional

Unique identifier for the cancellation request

order_itemintegerOptional

Order item ID

reasonintegerOptional

Cancellation reason ID

descriptionstring · nullableOptional

User-provided cancellation description

ibanstring · nullableOptional

IBAN for refund (for cash payment orders)

holder_namestring · nullableOptional

Account holder name for refund

quantityinteger · nullableOptional

Quantity being cancelled (for mergeable order items)

fully_refund_as_loyalty_moneyboolean · nullableOptional

Whether refund is issued as loyalty points

created_datestring · date-timeOptional

modified_datestring · date-timeOptional

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/

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": "name@gmail.com",
  "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-07-11",
        "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-07-11T07:29:19.857Z",
        "modified_date": "2026-07-11T07:29:19.857Z"
      }
    ],
    "created_date": "2026-07-11T07:29:19.857Z",
    "modified_date": "2026-07-11T07:29:19.857Z"
  }
]

PreviousOrders NextHooks

Last updated 1 month ago

Was this helpful?