coupang
API Documentation
ProductsCategoriesBrandsShipments & OrdersReturnsExchangesPromotions & CouponsLogistics InfoCustomer ServiceSettlementCGF / CGF liteRocket Growth
GET/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items/{vendorItemId}2609170000

[Instant Discount Coupon] Query one coupon (vendorItemId)

# 01

Summary

[Instant Discount Coupon] Query one coupon (vendorItemId)

# 02

Details

Available buyer market: Korea

This API queries currently available coupon items by vendor item ID.

Path

GET/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items/{vendorItemId}

Example endpoint

https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/A00000001/coupons/76/items/3223826213?type=vendorItemId
# 03

Path parameters

NameTypeDescription
vendorId*string
Vendor ID
couponId*number
Coupon ID (Wing's coupon no.)
vendorItemId*number
Vendor item ID
# 04

Query parameters

NameTypeDescription
type*string
vendorItemId
# 05

Response body

Response message

NameTypeDescription
codeinteger
Server response code
messagestring
Server response message
httpStatusinteger
HTTP Status Code (same as the server response code)
httpStatusMessagestring
HTTP Status Message (same as the server response message)
errorMessagestring
Detailed reason for error other than HTTP Status 200.
dataobject
Data on coupon item list
success
data.success
boolean
Success or failure
true or false
content
data.content
object
Coupon item list
couponItemId
data.content.couponItemId
integer
Coupon item ID
ex) 80984
couponId
data.content.couponId
integer
Coupon ID (Wing's coupon no.)
ex) 75, 80
vendorItemId
data.content.vendorItemId
integer
Vendor item ID
ex) 3223826213
startAt
data.content.startAt
string
Effective start date/time
ex) 2017-08-04 01:00:00
endAt
data.content.endAt
string
Effective end date/time
ex)2017-09-01 00:00:00
status
data.content.status
string
Coupon status
Code Description
STANDBY Standing by
APPLIED In use
PAUSED Issuance paused
EXPIRED Expired
Pagination
data.Pagination
object[]
No paging as it queries one coupon

Response Example

{
  "code": 200,
  "message": "OK",
  "httpStatus": 200,
  "httpStatusMessage": "OK",
  "errorMessage": "",
  "data": {
    "success": true,
    "content": {
      "couponItemId": 80984,
      "couponId": 76,
      "vendorItemId": 3223826213,
      "startAt": "2017-08-04 01:00:00",
      "endAt": "2017-09-01 00:00:00",
      "status": "APPLIED"
    },
    "pagination": null
  }
}
# 06

Error codes

HTTPCodeMessage
--