Authentication
Send the MMKX-API-KEY — that’s the only credential the caller handles. Your Coupang
token is set once on the connection page in the Magic Meal Kits app and resolved
server-side, so no per-request token header is needed — see
Authentication.
Order sheets and category lookup are Basic. The two consumer-order endpoints
(
orders, flattened-orders) are Pro — a Basic key gets 400
you are not a magic meal kits PRO user.Endpoints
| Endpoint | Tier | What it does |
|---|---|---|
POST /coupang/ordersheets | Basic | Seller order sheets for a created-at window |
POST /coupang/category | Basic | Look up a display category |
POST /coupang/orders | Pro | Consumer orders (paged by pageIndex/pageSize/year) |
POST /coupang/flattened-orders | Pro | Consumer orders flattened to one row per item |
Notes
- Order sheets take a created-at window (
createdAtFrom/createdAtTo, optionalstatus). Consumer orders takepageIndex/pageSize/yearinstead. - Flattened orders give you one row per order item — handy when mapping straight into a spreadsheet or downstream module.

