Changelog
Every change to the Ordexs API, newest first.
Changes inside v1 are always additive: new endpoints, new fields, new event types and new enum values. Your integration should ignore fields and values it doesn't recognise. Anything that would break an existing integration ships as v2, and v1 keeps working.
2026-11-11 — Abandoned checkouts the shopper finished are deleted
- When a shopper completes their own order, the abandoned checkout is now deleted instead of being kept with
status: recovered. Webhook endpoints receive a finalabandoned_checkout.updated(status: recovered, withorder_id) first; afterwardsGET /v1/abandoned_checkouts/{id}answers404.recoveredandconfirmednow only describe checkouts the team turned into orders. - Any new order with the same phone number within 48 hours clears that number's open checkouts the same way.
- One open checkout per phone number: a second checkout from the same number updates the existing one.
- Open checkouts with no activity for 30 days move to
status: deleted.
2026-11-10 — Storefront API: single pages
GET /pages/{page}now opens every published page. It answered404for all of them before.- The answer gains
kind(pageorlanding_page), andpathpoints to/lp/{handle}for landing pages. A landing page is built from blocks, so itsbody_htmlis usuallynull.
2026-11-09 — Storefront API
- New: the Storefront API, a public, read-only API for building a store's front end anywhere — products with search, filters and facets, collections, categories, navigation, pages, policies, reviews, live offers, regions and delivery prices, and
POST /cart/price, a server quote that prices a cart exactly as an order would. - It lives at
https://api.ordexs.com/storefront/v1/<store>/…and needs a public Storefront API token in theX-Ordexs-Storefront-Tokenheader. Stores create tokens under Settings → Developers → Storefront API, and choose which websites may use each one from a browser. The same API answers on the store's own address (https://<store>.myordexs.com/api/storefront/v1/…) without a token. - It is separate from this API (
/v1): nothing here changed. Its ids are plain UUIDs, and it accepts this API'sprod_…,var_…andofr_…ids for the same rows. Contract:/docs/storefront-api/openapi.json.
2026-11-03 — New files on cdn.myordexs.com
- Image, video and document URLs for files uploaded from now on start with
https://cdn.myordexs.com/(they werehttps://cdn.ordexs.com/). Files uploaded before keep their URLs, and both hosts serve every file. Same fields, same meaning; treat both hosts as Ordexs-hosted media.
2026-11-03 — Stores move to myordexs.com
- A store's free address is now
https://<store>.myordexs.com(it washttps://<store>.ordexs.com). Every URL the API and webhooks return for a store's public pages uses it: the store'surl, a product'surl, page and policyurls, and an order'sdelivery.tracking_url. Same fields, same meaning; only the host changes. Stores with their own domain are unchanged. - Old
<store>.ordexs.comaddresses keep working, and page addresses on them redirect (301) to the same path and query on the new domain. Links you already stored or sent to customers stay valid; there is nothing to migrate. - The API itself stays at
https://api.ordexs.com/v1.
2026-11-02 — Merged orders
- A shopper can add items to their own unconfirmed order from the checkout, which sends
order.updatedfor that order instead oforder.createdfor a new one. - The merchant's team can merge two open orders of the same customer. The merged order sends
order.status_changedandorder.cancelled, then is deleted (GETreturns404). See Merged orders.
2026-11-02 — Customer reliability is the delivery score
- A customer's
reliability.tieris nownew,reliable,uncertainorrisky(it wasnew,trusted,good,mixedorrisky), andreliability.scoreis the delivery score's percentage: delivered, returned and cancelled orders, with other Ordexs stores at half weight and recent orders weighing more. See Customers. GET /v1/analytics/customerscounts customers by the same four tiers inreliability, andtop_customers[].reliabilityuses them too.- This changes existing values inside
v1, an exception to the additive rule above, made before any integration depended on the old tiers.
2026-10-18 — Tracking links expire
delivery.tracking_urlnow stops working 3 days after the order is delivered or returned; the page then shows that the link has expired. A cancelled order has no tracking page. The URL itself doesn't change.
2026-10-17 — Customer tracking link
- Orders:
delivery.tracking_url, the customer's tracking page for the order (https://<store>.ordexs.com/track/<code>).nullin test mode. See Shipping and tracking. - Fixed: since 2026-10-15 orders were missing
preorder,assigned_to,type,exchange_of,collect,discount_nameandoffer_ids, anddiscount_codeheld the discount's name instead of its code. They are back as documented.
2026-10-13 — Card payments on orders
- Stores can now take card payment (CIB / Edahabia through the merchant's own Slick-Pay account), in full or as a deposit with the rest in cash on delivery.
- Orders:
payment.methodaddscardandcard_deposit;payment.statusaddspendingandpartially_paid; newpayment.amount_paidandpayment.amount_to_collect. order.updatedalso fires when a card payment lands or the payment method changes.- Order form: a new button id,
pay_card(GET/PATCH /v1/order_form). payment.card_discount: a store can give a discount for paying by card; it is included indiscountand taken offtotal, and given back if the order switches to cash on delivery.
2026-10-13 — What connected apps need
- Webhook endpoints created with an OAuth token belong to that connection: the app sees and changes only its own, and they are deleted when the merchant disconnects the app.
- Products:
urlis now the product's storefront page (null while unpublished and in test mode);GET /v1/products?handle=finds a product from its storefront address. - Orders:
shipping_address.region(andGET /v1/delivery/rates?region=) also take an ISO code (DZ-16) or a region name (Alger,الجزائر), up to 60 characters. out_of_stocknow carriesdetails.lines: each short line with itsavailable_quantity.
2026-10-13 — OAuth apps
- Apps can now be connected with an approval instead of a copied key: register an app under Settings → Developers → Your apps, send merchants to
https://admin.ordexs.com/oauth/authorize(authorization code + PKCE S256), thenPOST https://api.ordexs.com/oauth/token(authorization_code,refresh_token) andPOST https://api.ordexs.com/oauth/revoke. See OAuth apps. - Access tokens look like API keys (
ordx_live_…/ordx_test_…) and last one hour; an expired one answers401 invalid_api_keywith a message saying to refresh.
2026-10-13 — Bulk jobs and exports
- Bulk jobs:
POST /v1/bulk_uploads(a slot for the NDJSON file),POST /v1/bulk_jobs(orders.create, orders.update, products.create, products.update, inventory.adjust; up to 10,000 lines),GET /v1/bulk_jobs(+/{job_id}),GET …/{job_id}/results,POST …/{job_id}/cancel; eventbulk_job.completed. GET /v1/orders/export: matching orders as streamed NDJSON, up to 100,000.
2026-10-13 — Marketing pixels
GET/POST /v1/pixels,GET/PATCH/DELETE /v1/pixels/{pixel_id}(Meta, TikTok, Google, Snapchat, Pinterest, custom). Conversions API tokens stay in the dashboard.- New scopes
marketing:readandmarketing:write.
2026-10-13 — Store content
PATCH /v1/store: name, contact, address, storefront language, timezone, order prefix.GET /v1/storegainslanguage,timezone,order_prefix,contactandaddress.- Policies:
GET /v1/policies,GET/PUT/DELETE /v1/policies/{kind}. - Pages:
GET/POST /v1/pages,GET/PATCH/DELETE /v1/pages/{page_id},POST …/duplicate. GET/PATCH /v1/order_form: the checkout form's fields, buttons and general settings.- New scopes
content:readandcontent:write.
2026-10-13 — Analytics
GET /v1/analytics/overview(a period, or a custom range),GET /v1/analytics/customers(customer insights, for everyone or one segment) andGET /v1/analytics/team. Read only, computed by the same code as the dashboard.- New scope
analytics:read.
2026-10-12 — Editing orders with a courier
PATCH /v1/orders/{order_id}now works on an order already with a courier: the change is sent to the courier first and saved only if it accepts it (courier_rejectedotherwise), for the details that courier accepts, until the parcel is validated or picked up. It used to be refused withinvalid_state_transitionas soon as the order had a parcel.
2026-10-12 — Delivery setup
GET /v1/couriers: the store's courier accounts.GET/PATCH /v1/delivery/settings(strategy, modes, labels, the couriers whose rates are used, the default courier) andGET/PATCH /v1/delivery/prices(the store's prices per region).- Routing rules:
GET/POST /v1/delivery/routing_rules,PATCH/DELETE /v1/delivery/routing_rules/{rule_id}. - New scopes
delivery:readanddelivery:write.
2026-10-12 — Product images and media
POST /v1/products/{product_id}/imagesfrom aurl, anupload_id(POST /v1/uploadsgives a slot to PUT a file to) or amedia_id;PATCHandDELETE /v1/products/{product_id}/images/{image_id}.- Product images gain
id.PATCH /v1/variants/{variant_id}takesimage_id. GET /v1/mediaandGET /v1/media/{media_id}: the store's media library.products:writenow also covers adding files to the media library;products:readreading it.
2026-10-12 — Returns and cash
- Returns:
GET /v1/returns(+/{order_id}),POST /v1/returns/{order_id}/receiveandPOST /v1/returns/check_in(back to stock or written off; Ecotrack-family couriers are told). - Cash on delivery:
GET /v1/cod_balances,GET /v1/cod_orders, and payoutsGET/POST /v1/payouts,GET/DELETE /v1/payouts/{id},GET /v1/payouts/{id}/orders. - New scopes
money:readandmoney:write.
2026-10-12 — Offers and discounts
- Offers:
GET/POST /v1/offers,GET/PATCH/DELETE /v1/offers/{id}andGET /v1/offers/{id}/performance, for bundles, upsells (quantity packs) and cross-sells. - Discounts:
GET/POST /v1/discounts(filter bycode,kind,status),GET/PATCH/DELETE /v1/discounts/{id}andPOST /v1/discounts/preview(check a code). POST /v1/ordersand/v1/orders/previewtakeoffer_ids. Orders gainoffer_idsanddiscount_name.- Fixed: an order's
discount_codeheld the discount's name instead of the code. It is now the code, and the name moved todiscount_name. - New scopes
offers:readandoffers:write; new error codeduplicate_discount_code.
2026-10-12 — Collections, categories and reviews
- Collections:
GET/POST /v1/collections,GET/PATCH/DELETE /v1/collections/{id},POST …/{id}/duplicate,GET …/{id}/products,POST /v1/collections/reorder,POST /v1/collections/preview. Products gaincollection_ids. GET /v1/categories.- Reviews:
GET/POST /v1/reviews,PATCH/DELETE /v1/reviews/{id},GET/PATCH /v1/review_settings; eventreview.created.
2026-10-12 — Customer extras
- Customers gain
reliability(score and tier),whatsapp_opt_inandwhatsapp_opt_in_at;PATCH /v1/customers/{id}takeswhatsapp_opt_in. GET /v1/orders?customer_id=….GET /v1/customer_segmentsandGET /v1/customer_segments/{segment_id}/customers.
2026-10-12 — Abandoned checkouts and shipping extras
- Abandoned checkouts:
GET /v1/abandoned_checkouts(+/{id}),PATCH,DELETE,POST …/{id}/confirm,POST /v1/abandoned_checkouts/assign; eventsabandoned_checkout.createdandabandoned_checkout.updated. - Shipments:
POST /v1/shipments/{id}/pack,…/validate,…/refresh;POST /v1/orders/{id}/tracking. Shipments gainpacked_atandlast_checked_at.
2026-10-12 — Working orders
POST /v1/orders/assignandGET /v1/team_members(new scopeorders:assign);POST /v1/orders/archive.- The contact log:
GET/POST /v1/orders/{order_id}/contacts,PATCH /v1/orders/{order_id}/contacts/{contact_id}. DELETE /v1/orders/{order_id}/notes/{note_id}(notes the key wrote).PATCH /v1/orders/{order_id}takesscheduled_forandcourier. Orders gainassigned_to.
2026-10-12 — Order types and line edits
POST /v1/orderstakestype(delivery,exchange,pickup,cash_collection) andcollect, custom lines (title+unit_price), hand-setunit_price,shipping_feeandtotal, like the dashboard's Create order.line_itemsis no longer required for a pickup or a cash collection.PATCH /v1/orders/{order_id}takesline_items,shipping_feeandtotal.- Orders gain
type,exchange_ofandcollect.
2026-10-12 — Inventory
- Inventory levels:
GET /v1/inventory(filters, search, sorts) andGET /v1/inventory/{variant_id}. POST /v1/inventory/adjustments: up to 100 stock changes with a reason, all or nothing.GET /v1/inventory_movements: the stock history, with who made each change.GET/PATCH /v1/inventory_settings(low-stock alert level).- Variants gain
allow_backorder,incoming_due_atandat_courier;PATCH /v1/variants/{id}sets them andincoming;PATCH /v1/products/{id}setsallow_preorder;POST /v1/variants/{id}/receive_incoming. - Stock counts:
GET/POST /v1/stock_counts,GET /v1/stock_counts/{id},POST …/lines,…/apply,…/discard. - New scopes
inventory:readandinventory:write.
2026-10-12 — Pre-orders and create-and-send
POST /v1/orderstakespreorder: true(lines may take units from the incoming delivery, like the dashboard's Pre-order switch) andship: { courier_id? }(send to the courier right after creating; the answer addsshipmentorship_error). Orders gainpreorder.
2026-10-12 — Shipping
POST /v1/orders/{order_id}/shipsends an order to the store's courier, exactly as the dashboard's Send to courier does. Test keys get a simulated shipment.- Shipments:
GET /v1/shipments,GET /v1/shipments/{shipment_id},GET /v1/shipments/{shipment_id}/label(the label file) andPOST /v1/shipments/{shipment_id}/cancel. POST /v1/test_helpers/shipments/{shipment_id}/advancemoves a test shipment along (test keys only).- New scopes
shipping:readandshipping:write; new eventsshipment.createdandshipment.updated; new error codescourier_not_configuredandcourier_rejected.
2026-10-12 — Developer docs
- The docs at
ordexs.com/docs: guides, a reference page for every endpoint with cURL, Node, PHP and Python samples, a page for every webhook event, and search. - The OpenAPI 3.1 contract is downloadable at
ordexs.com/docs/openapi.json. - Corrected the spec's descriptions of
source_name,region_label, the ordernote,previous_attributesandrequest.api_key_id, which had been cut short. No behaviour changed.
2026-10-11 — Webhooks
- Webhook endpoints:
GET/POST /v1/webhook_endpoints,GET/PATCH/DELETE /v1/webhook_endpoints/{webhook_endpoint_id},POST …/rotate_secretandPOST …/test. - Events:
order.created,order.updated,order.status_changed,order.cancelled,order.needs_review,order.note_added,product.created,product.updated,product.deleted,inventory.updated,customer.created,customer.updated, andping. - Every delivery is signed:
Ordexs-Signature: t=<unix>,v1=<hmac-sha256>. During a secret rotation it carries a secondv1signed with the previous secret. GET /v1/eventsandGET /v1/events/{event_id}: the last 30 days.- Failed deliveries are retried for 3 days. An endpoint that fails for 3 days straight is turned off, and the store owner is told.
2026-10-11 — Write API
- Orders:
POST /v1/orders,POST /v1/orders/preview,PATCH /v1/orders/{order_id},POST /v1/orders/{order_id}/status,POST /v1/orders/{order_id}/cancelandPOST /v1/orders/{order_id}/notes. The store prices every order: line items take avariant_idand aquantity, never a price. - Orders gain
source_name,external_id,needs_reviewandmetadata, and the list takesexternal_id,sourceandneeds_reviewfilters.external_idis unique per store andsource_name, so a retried create can't make a second order. - An order whose city isn't recognised is still created, with
needs_review: "city_unmatched". It can't go to a courier until the merchant confirms the address. - Products:
POST /v1/products,PATCH /v1/products/{product_id},DELETE /v1/products/{product_id}(archives),POST /v1/products/{product_id}/variants,PATCH /v1/variants/{variant_id}andDELETE /v1/variants/{variant_id}. Settinginventory_quantityis recorded in the store's inventory history. - Customers:
POST /v1/customersandPATCH /v1/customers/{customer_id}. Customerstatusgains the valueneeds_followup. - Every
POSTaccepts anIdempotency-Keyheader (24 hours). - New error codes:
duplicate_customer.
2026-10-09 — Read API
GET /v1/products,GET /v1/products/{product_id}andGET /v1/variants/{variant_id}. A variant's stock or price change moves its product'supdated_at, soupdated_sincecatches stock changes.GET /v1/orders,GET /v1/orders/{order_id},GET /v1/orders/{order_id}/notesandGET /v1/orders/{order_id}/history. Filter orders bystatus,number,phone,archived,created_sinceandupdated_since.GET /v1/customersandGET /v1/customers/{customer_id}.GET /v1/countries,GET /v1/regions,GET /v1/citiesandGET /v1/delivery/rates.- Every list uses cursor pagination (
limit,cursor,next_cursor).
2026-10-09 — First release
- API keys (
ordx_live_…,ordx_test_…), scopes, test mode and rate limits. GET /v1/store.
