Skip navigation
REST › orders.list

orders.list

GET/orders

The account's 50 most recent orders, newest first, with status, amount and the transfer details of pending ones. Needs a key.

Parameters

ParameterInDescription
statusqueryOptional. Keeps only orders in this state: pending, paid, expired or refunded.
limitqueryOptional. Orders per page, 1 to 100. Leave it out to get the whole list.
offsetqueryOptional. How many orders to skip, default 0. For the next page pass the response's nextOffset; the last page has none.

Request

curl
curl "https://api.modernengineer.dev/orders?status=paid&limit=10" \
  -H "Authorization: Bearer $SE_KEY"

Response

200 OK · application/json
{
  "items": [
    {
      "code": "ME17730452",
      "sku": "orca-cook-plan",
      "kind": "retail",
      "label": "orca-cook-plan",
      "amountVnd": 149000,
      "listAmountVnd": 149000,
      "discountVnd": 0,
      "discountCode": null,
      "periodMonths": null,
      "packSlug": "orca-cook-plan",
      "status": "paid",
      "expiresAt": "2026-10-21T08:40:00.000Z",
      "paidAt": "2026-10-20T08:52:11.000Z",
      "createdAt": "2026-10-20T08:40:00.000Z",
      "payment": null,
      "testMode": false
    }
  ],
  "total": 1
}

Errors

StatusErrorWhen
401unauthenticatedThe API key is missing or invalid. Comes with a WWW-Authenticate header.
400invalid_inputA parameter is missing or invalid, for example a locale other than vi or en.

In MCP