API Documentation
Coupang Open API is a RESTful API. Requests and responses are JSON over HTTPS, signed with HMAC-SHA256.
API families
Products
Create, query, and update product listings, including approval and attributes.
BrowseCategories
Browse, recommend, validate Coupang categories and metadata.
BrowseBrands
Query registered brands, retrieve by ID, and search.
BrowseShipments & Orders
Daily/minute order lists, single-order lookup, tracking upload, and shipment status.
BrowseReturns
Return/cancel request lists, approvals, inbound confirmation, withdrawal lookup.
BrowseExchanges
Exchange request lists, inbound confirmation, rejection, tracking upload.
BrowsePromotions & Coupons
Instant coupons, contracts, budgets, cashback management.
BrowseLogistics Info
Create, query, and edit outbound and return locations.
BrowseCustomer Service
Customer inquiries and replies, integration with Coupang call center.
BrowseSettlement
Sales and settlement detail queries.
BrowseCGF / CGF lite
Coupang Global Fulfillment listing and tracking endpoints.
BrowseRocket Growth
Rocket Growth / Rocket Growth Marketplace co-op products.
BrowseAll endpoints
| Method | Path | Title | Family | Markets |
|---|---|---|---|---|
| GET | /v2/providers/fms/apis/api/v2/vendors/{vendorId}/contract/list | (Common) Query contract list | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v2/vendors/{vendorId}/contract | (Common) Query single contract | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v1/vendors/{vendorId}/budgets | (Common) Run a query on budget status | Promotions & Coupons | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashback | [Book] Applying Cashback | Promotions & Coupons | KR |
| GET | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashback | [Book] Product Cashback Search | Promotions & Coupons | KR |
| DELETE | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashback | [Book] Removing Product Cashback | Promotions & Coupons | KR |
| GET | /v2/providers/marketplace_openapi/apis/api/v1/coupons/transactionStatus | [Downloadable Coupon] check requested status | Promotions & Coupons | KR |
| POST | /v2/providers/marketplace_openapi/apis/api/v1/coupons | [Downloadable Coupon] creation | Promotions & Coupons | KR |
| POST | /v2/providers/marketplace_openapi/apis/api/v1/coupons/expire | [Downloadable Coupon] Expiring Download Coupon | Promotions & Coupons | KR |
| PUT | /v2/providers/marketplace_openapi/apis/api/v1/coupon-items | [Downloadable Coupon] Item Creation | Promotions & Coupons | KR |
| GET | /v2/providers/marketplace_openapi/apis/api/v1/coupons/{couponId} | [Downloadable Coupon] query one coupon (couponId) | Promotions & Coupons | KR |
| POST | /v2/providers/openapi/apis/api/v1/vendors/{vendorId}/orders/directIntegration/arrangeShipment | [For Taiwan Only]Arrange shipment for directly integrated courier | Shipments & Orders | KR |
| POST | /v2/providers/openapi/apis/api/v1/vendors/{vendorId}/orders/directIntegration/downloadInvoices | [For Taiwan Only]Download invoice for direct integrated courier | Shipments & Orders | KR |
| PUT | /v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId} | [Instant Discount Coupon] Expiration/ Disable | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v1/vendors/{vendorId}/requested/{requestedId} | [Instant Discount Coupon] Check request status | Promotions & Coupons | KR |
| POST | /v2/providers/fms/apis/api/v2/vendors/{vendorId}/coupon | [Instant Discount Coupon] Creation | Promotions & Coupons | KR |
| POST | /v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items | [Instant Discount Coupon] Item Addition | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v2/vendors/{vendorId}/{orderId}/coupons | [Instant Discount Coupon] Query a list of coupons (orderId) | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v2/vendors/{vendorId}/coupons | [Instant Discount Coupon] Query a list of coupons (status) | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items | [Instant Discount Coupon] Query a list of items (status) | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v2/vendors/{vendorId}/coupon | [Instant Discount Coupon] Query one coupon (couponId) | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items/{couponItemId} | [Instant Discount Coupon] Query one coupon (couponItemId) | Promotions & Coupons | KR |
| GET | /v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items/{vendorItemId} | [Instant Discount Coupon] Query one coupon (vendorItemId) | Promotions & Coupons | KR |
| POST | /v2/providers/seller_api/apis/api/v1/marketplace/seller/auto-generated/opt-in | Activate auto-generated option (total product unit) | Products | KR |
| POST | /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/auto-generated/opt-in | Activate auto-generated option (option product unit) | Products | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/onlineInquiries/{inquiryId}/replies | Answer to Customer Product Inquiry | Customer Service | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/callCenterInquiries/{inquiryId}/replies | Answer to Inquiries via Coupang Contact Center | Customer Service | KR |
| PATCH | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approval | Approve request for return | Returns | KR |
| POST | /v2/providers/seller_api/apis/api/v1/marketplace/brands/search | Brand Search | Brands | KR |
| POST | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/orders/{orderId}/cancel | Cancel an order | Shipments & Orders | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode} | Category Metadata Query | Categories | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode} | Category Metadata Query | Rocket Growth | KR |
| POST | /v2/providers/openapi/apis/api/v1/categorization/predict | Category recommendation | Categories | KR |
| POST | /v2/providers/openapi/apis/api/v1/vendors/{vendorId}/label/printOrderLabel | CGF Lite order Label API | CGF / CGF lite | KR |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/original-prices/{originalPrice} | Change the base price for discount rate at an item level | Products | KR |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/prices/{price} | Changing price of each item of a product | Products | KR |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/quantities/{quantity} | Changing quantity of each product item | Products | KR |
| PATCH | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/acknowledgement | Changing the status to Product in Preparation | Shipments & Orders | KR |
| PATCH | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests/{exchangeId}/receiveConfirmation | Check the receipt of exchange-requested product | Exchanges | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/vendors/{vendorId}/check-auto-category-agreed | Confirmation of category auto matching service agreement | Categories | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/callCenterInquiries/{inquiryId}/confirms | Coupang Contact Center Inquiry Check | Customer Service | KR |
| ETC | Courier Code | Logistics Info | KR | |
| POST | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters | Create a return location | Logistics Info | KR |
| POST | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters | Create a shipping location | Logistics Info | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiries | Customer Inquiry Query by Product | Customer Service | KR |
| DELETE | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId} | Delete a Product | Products | KR |
| POST | /v2/providers/seller_api/apis/api/v1/marketplace/seller/auto-generated/opt-out | Disable auto-generated option (total product unit) | Products | KR |
| POST | /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/auto-generated/opt-out | Disable auto-generated option (option product unit) | Products | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/brands/enrolled | Enrolled Brands List | Brands | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/brands/{brandId} | Get Brand by ID | Brands | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories/{displayCategoryCode}/status | How to check validity of a category | Categories | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories/{displayCategoryCode} | How to get categories | Categories | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories | How to get category list | Categories | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories | How to get category list for Rocket Growth Products | Rocket Growth | KR |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products | Modify Product | Products | KR |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products | Modify Product (Rocket Growth & Rocket Growth/Marketplace Hybrid Products) | Rocket Growth | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets | PO list query (by Minute) | Shipments & Orders | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets | PO list query (paging by day) | Shipments & Orders | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/completeLongTermUndelivery | Process Orders Long Past Their Promised Delivery Date as 'Delivery Completed' | Shipments & Orders | KR |
| PATCH | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/completedShipment | Processing 'already released' | Shipments & Orders | KR |
| PUT | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/stoppedShipment | Processing 'Release stop' | Shipments & Orders | KR |
| POST | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products | Product Creation | Products | KR |
| POST | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products | Product Creation (Rocket Growth & Rocket Growth/Marketplace Hybrid Products) | Rocket Growth | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products | Product list paging query | Products | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products | Product list paging query (Rocket Growth & Rocket Growth/Marketplace Hybrid Products) | Rocket Growth | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame | Product list ranging query | Products | KR |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial | Product Modification (Approval not required) | Products | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/histories | Query a history of product status updates | Products | KR |
| GET | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests | Query a list of exchange requests | Exchanges | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters | Query a list of return locations | Logistics Info | KR |
| GET | /v2/providers/marketplace_openapi/apis/api/v2/vendor/shipping-place/outbound | Query a shipping location | Logistics Info | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/inflow-status | Query a status of product registration | Products | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/external-vendor-sku-codes/{externalVendorSkuCode} | Query a summary of product info | Products | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/callCenterInquiries | Query of Coupang Contact Center Inquiries | Customer Service | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/{inquiryId} | Query of Coupang Contact Center Single Inquiry | Customer Service | KR |
| GET | /v2/providers/openapi/apis/api/v3/return/shipping-places/center-code | Query one return location | Logistics Info | KR |
| GET | /v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests/{receiptId} | Query one return request | Returns | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId} | Query Product (Rocket Growth or Rocket Growth/Marketplace Hybrid Products) | Rocket Growth | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/inventories | Query quantity/price/status by product items | Products | KR |
| GET | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnWithdrawRequests | Query return return withdrawal history by date range | Returns | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnWithdrawList | Query return withdrawal history by receiptID | Returns | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId} | Querying product | Products | KR |
| GET | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial | Querying product (Approval not required) | Products | KR |
| PATCH | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests/{exchangeId}/rejection | Reject an exchange request | Exchanges | KR |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/approvals | Request for product approval | Products | KR |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/sales/resume | Resume sales of each item of a product | Products | KR |
| GET | /v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests | Return / Cancellation Request List Query | Returns | KR |
| PATCH | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/receiveConfirmation | Return product receipt confirmation | Returns | KR |
| GET | /v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries | RG Inventory API | Rocket Growth | KR |
| GET | /v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/orders | RG Order API(List Query) | Rocket Growth | KR |
| GET | /v2/providers/openapi/apis/api/v1/revenue-history | Sales Detail Query | Settlement | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history | Searching Delivery Status Change History | Shipments & Orders | KR |
| GET | /v2/providers/marketplace_openapi/apis/api/v1/settlement-histories | Settlement Detail Query | Settlement | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId} | Single PO query (using shipmentBoxId) | Shipments & Orders | KR |
| GET | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/{orderId}/ordersheets | Single PO query (using orderId) | Shipments & Orders | KR |
| ETC | South Korean cities and postal codes | Shipments & Orders | KR | |
| PUT | /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/sales/stop | Suspend sale of each item of a product | Products | KR |
| PUT | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode} | Update a return location | Logistics Info | KR |
| PUT | /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters/{outboundShippingPlaceCode} | Update a shipping location | Logistics Info | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/updateInvoices | Updating Waybills | Shipments & Orders | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/return-exchange-invoices/manual | Upload a pickup waybill | Returns | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests/{exchangeId}/invoices | Upload a waybill for exchange product | Exchanges | KR |
| POST | /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/invoices | Uploading Waybills | Shipments & Orders | KR |
Recent Notices
- [Notice] Coupang Open API Developer Portal Renewal2026-07-03
- Product Information Policy Update – Mandatory Brand, GTIN/Model Number, and Purchase Option Fields (Published on May 21, 2026)2026-06-11
- Clarification on Product Identifier (GTIN/Model Number) Requirement and Scope(Published on May 27, 2026)2026-06-11