Available buyer market: Korea
This API is used to retrieve brand details by brandId.
Path
GET
/v2/providers/seller_api/apis/api/v1/marketplace/brands/{brandId}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/brands/{brandId}
Request Parameters
Body Parameter
| Name | Required | Type | Description |
|---|---|---|---|
| brandId | O | String | Unique brand identifier (e.g. KR-5) |
Request Example
None
Response Message
| Name | Type | Description | |
|---|---|---|---|
| code | String | Result code SUCCESS/ERROR | |
| message | String | Result message | |
| data | Object | ||
| brandId | String | Unique brand identifier (e.g. KR-5) | |
| brandName | String | Brand name (e.g. NIKE) | |
| brandLogoUrl | String | Brand logo image URL (null if not available) | |
| isUIDRequired | Boolean | Whether UID (GTIN or MPN) is required for this brand | |
| allowedUIDTypes | Array[String] | List of allowed UID types (e.g. ["GTIN", "MPN"]) | |
Response Example
{
"code": "SUCCESS",
"message": "",
"data": {
"brandId": "KR-5",
"brandName": "NIKE",
"brandLogoUrl": "https://image11.coupangcdn.com/image/brand/logo/nike.png",
"isUIDRequired": true,
"allowedUIDTypes": ["GTIN", "MPN"]
}
}Error Spec
| HTTP status code (error type) | Error message | How to resolve |
|---|---|---|
| 400 Bad Request | Failed to retrieve brand. | Ensure the brandId is valid. |
| 400 Bad Request | Invalid brandId format. | Verify the brandId format (e.g. KR-5). |