Get Order Details

Retrieve comprehensive information about a specific order, including its status, delivery data, and purchased items.

Fetch Order Information

Use this endpoint to check the live status of an order. For completed digital products, this endpoint will return the sensitive delivery data (credentials, accounts, etc). You must authenticate using your API key.

Enter the 12-character alphanumeric Order ID you received during the checkout process.

GET
https://api.hsmail.shop/v1/order/U35MFE9656S7
Headers:Authorization: (Not Set - Set in Topbar)

Response Schema

A successful request returns a JSON object containing the order details. The structure dynamically adapts depending on whether the order is completed, in progress, or a service order.

FieldTypeDescription
statusStringAlways returns success or error.
dataObjectThe main payload containing the order details.
data.idStringThe unique 12-character alphanumeric identifier for this order.
data.productNameStringThe exact name of the purchased product or service.
data.statusStringCurrent state: PENDING, PROCESSING, COMPLETED, or REFUNDED.
data.statusMessageStringA human-readable explanation of the current status (e.g., "Order is processing. Admin will complete it soon").
data.totalCostNumberTotal amount deducted from your balance in BDT.
data.isServiceBooleanTrue if the product requires manual admin delivery (e.g., boosting, top-ups). False for instant digital goods.
data.deliveryDataString | nullFor completed instant API orders, this contains the raw delivery string (items separated by newlines). Null if pending or not applicable.
data.itemsArray | undefinedFor completed manual products, an array of objects containing the delivered uid and content.
data.createdAtString (Date)ISO 8601 timestamp of when the order was initially placed.

Important Note on Delivery Data

If an order's status is PENDING or PROCESSING, the deliveryData and items fields will generally be unavailable or empty. You must poll this endpoint periodically until the status changes to COMPLETED to extract your purchased credentials.