Products Categories Brands Shipments & Orders Returns Exchanges Promotions & Coupons Logistics Info Customer Service Settlement CGF / CGF lite Rocket Growth

Customer Service

GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/callCenterInquiries2609170000

Query of Coupang Contact Center Inquiries

# 01

Summary

# 02

Details

Available buyer market: Korean, Taiwan

You can look up inquiries made to the Coupang Contact Center. Find inquiries that Customers made to the Coupang Contact Center about certain products.
a. If you have both option ID and query period, you can look up all the consultations for the given option ID and query period.
b. If you only have the option ID, you can look up consultations for the given option ID.
c. If you only have the query period, you can look up consultations for the given period.

You can set up to 7 days for the query period range.

Path

GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/callCenterInquiries

Example endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/callCenterInquiries?inquiryStartAt=2018-01-07&inquiryEndAt=2018-01-08&vendorId=A00012345&partnerCounselingStatus=NO_ANSWER&pageSize=10&pageNum=1

URL API Name

GET_INQUIRY_BY_QUERY

# 03

Path parameters

Name	Type	Description
vendorId*	string	Seller ID
vendorId*	string	Seller ID

# 04

Query parameters

Name

Type

Description

partnerCounselingStatus*

string

Inquiry status

Name	Status
NONE	All
ANSWER	Answered
NO_ANSWER	Unanswered: The seller's answer is needed
TRANSFER	Unconfirmed: Coupang completed consultation and transferred the case to the seller, requiring the seller's confirmation. No answer required.

inquiryStartAt

string

Query start date; Format: yyyy-MM-dd

Where 'vendorItemId' is null, this parameter must be entered for the query.
You can look up the list of all the consultations between the query start and end dates.(inquiryEndAt - inquiryStartAt = 7d)
If you have 'vendorItemId', you do not need this parameter for the query.
a. If the query start and end dates are null, you can look up the list of all consultations for the given 'vendorItemId'.
b. If you have the query start and end dates, you can look up the list of all the consultations for the given period.

inquiryEndAt

string

Query end date; Format: yyyy-MM-dd

orderId

number

Order number

Example: 1900000*******

vendorItemId

string

Option ID

If the query start and end dates are null, you must use this parameter to look up the list of all the consultations for the given 'vendorItemId'.
If you have the query start and end dates, you do not need to enter this parameter.

pageNum

number

Current page
Default: 1

pageSize

number

Page size
Default: 10; Maximum: 30

# 05

Response body

Response message

Name

Type

Description

code

number

Server response code

message

string

Server response message

data

object

Result

content

data.content

object[]

Result

inquiryId

data.content[].inquiryId

number

Consultation number
Question ID

inquiryStatus

data.content[].inquiryStatus

string

Inquiry status
Progress or complete

csPartnerCounselingStatus

data.content[].csPartnerCounselingStatus

string

Answer status
requestAnswer or answered

vendorItemId

data.content[].vendorItemId

number

Option ID

itemName

data.content[].itemName

string

Item name

content

data.content[].content

string

Content of inquiry
Content of question

answeredAt

data.content[].answeredAt

string

Answered date (Requires ISO-8601 Compliance)
YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

replies

data.content[].replies

object[]

List of reply

answerId

data.content[].replies[].answerId

number

Answer ID

parentAnswerId

data.content[].replies[].parentAnswerId

string

ID of the inquiry transferred to the parent

partnerTransferStatus

data.content[].replies[].partnerTransferStatus

string

Seller transfer status;
none (not applicable) or requestAnswer (answer requested) or answered (answered)

partnerTransferCompleteReason

data.content[].replies[].partnerTransferCompleteReason

string

Reason for processing the inquiry transferred to the seller

CODE	NAME
NONE	None
DISPUTE_PROCESS	Discretionary processing
DISPUTE_PROCESS_COMPLETE	Seller confirmed
CANCEL	Transfer cancelled

answerType

data.content[].replies[].answerType

string

Type of the person who answered
csAgent (CS agent) or vendor (seller)

needAnswer

data.content[].replies[].needAnswer

boolean

Whether an answer is required or not;
True or false

receptionistName

data.content[].replies[].receptionistName

string

Agent name

receptionist

data.content[].replies[].receptionist

string

Agent

replyAt

data.content[].replies[].replyAt

string

Replied date (Requires ISO-8601 Compliance)

YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

content

data.content[].replies[].content

string

Content of the answer

inquiryAt

data.content[].inquiryAt

string

Inquiry date (Requires ISO-8601 Compliance)
YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

buyerEmail

data.content[].buyerEmail

string

non-use/empty value("")

buyerPhone

data.content[].buyerPhone

string

Customer phone number

orderId

data.content[].orderId

integer

Order number
Example: 1900000*******

orderDate

data.content[].orderDate

string

Order time/date (Requires ISO-8601 Compliance)
YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

receiptCategory

data.content[].receiptCategory

string

Inquiry type

saleStartedAt

data.content[].saleStartedAt

string

Sales start time/date

saleEndedAt

data.content[].saleEndedAt

string

Sales end time/date

pagination

data.pagination

object

Pagination information

currentPage

data.pagination.currentPage

number

Current page
Default: 1

totalPages

data.pagination.totalPages

number

Total number of page

totalElements

data.pagination.totalElements

number

Total number of inquiry

countPerPage

data.pagination.countPerPage

number

Number of inquiry per page

Response Example

{
 "code": 200,
 "message": "OK",
 "data": {
 "content": [
 {
 "inquiryId": 1015668177,
 "csPartnerCounselingStatus": "answered",
 "inquiryStatus": "progress",
 "vendorItemId": [
 3285906659
 ],
 "itemName": "스파오(SPAO) 인조가죽 A라인 4부 스커트 SPWH749G22, (49)Khaki, L",
 "content": "상담이력",
 "answeredAt": "2025-01-15T14:17:13.973885-08:00",
 "replies": [
 {
 "receptionistName": "AA몰",
 "receptionist": "10000058",
 "replyAt": "2025-01-15T14:17:13.973885-08:00",
 "content": "[판매자이관]\n◼주문번호: 100000*******\n◼아이템: 스파오(SPAO) 인조가죽 A라인 4부 스커트 SPWH749G22, (49)Khaki, L\n◼고객명/연락처: &lt;&lt;****/01*-****-****&gt;&gt;\n◼문의내용: 고객 상품 반송하였다고 합니다. 반송장은 경비실에 맡겨서 모른다고 합니다.\n입고 확인후 환불 처리 부탁 드립니다.\n",
 "answerId": 1027082307,
 "parentAnswerId": 0,
 "partnerTransferStatus": "answered",
 "partnerTransferCompleteReason": "NONE",
 "answerType": "csAgent",
 "needAnswer": false
 },
 {
 "receptionistName": "AA몰",
 "receptionist": "elandmall",
 "replyAt": "2025-01-15T14:17:13.973885-08:00",
 "content": "안녕하세요, \r\nAA몰입니다.\r\n\r\n1/3일 입고 된것으로 확인됩니다.\r\n\r\n3영업일이 정상 검수기간으로 시일이 소요되기에 양해 바랍니다.\r\n\r\n감사합니다.\r\n",
 "answerId": 1027083739,
 "parentAnswerId": 0,
 "partnerTransferStatus": null,
 "partnerTransferCompleteReason": "NONE",
 "answerType": "vendor",
 "needAnswer": false
 }
 ],
 "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
 "buyerEmail": "",
 "buyerPhone": "+1(555)444-1234",
 "orderId": 1000001*******6,
 "orderDate": "2025-01-15T14:17:13.973885-08:00",
 "receiptCategory": "기타문의&gt;기타&gt;전상담사통화요청",
 "saleStartedAt": "2017-12-12",
 "saleEndedAt": "2099-12-30"
 },
 {
 "inquiryId": 1015664934,
 "csPartnerCounselingStatus": "answered",
 "inquiryStatus": "progress",
 "vendorItemId": [
 3361159025
 ],
 "itemName": "스파오(SPAO) 몬스터주식회사 맨투맨 (디즈니)_D/GYAY SPMB74VC19, (17)Dark Gray, S",
 "content": "상담이력",
 "answeredAt": "2025-01-15T14:17:13.973885-08:00",
 "replies": [
 {
 "receptionistName": "AA몰",
 "receptionist": "D002236",
 "replyAt": "2025-01-15T14:17:13.973885-08:00",
 "content": "[입고완료이관] \nㅁ 고객명: ******\nㅁ 주문번호:100000******\nㅁ 반송장번호: ********* CJ대한통운\nㅁ 입고일자: 12/30\n반송장조회 결과 입고완료로 확인됩니다. \n★환불승인★ 부탁드립니다. \n반품입고후 3영업일이 경과되면 환불 자동승인처리가 \n되오니, 입고 상품의 문제발생 시 쿠팡확인요청으로 \n이의제기를 등록해주셔야 합니다.",
 "answerId": 1027076645,
 "parentAnswerId": 0,
 "partnerTransferStatus": "answered",
 "partnerTransferCompleteReason": "NONE",
 "answerType": "csAgent",
 "needAnswer": false
 },
 {
 "receptionistName": "AA몰",
 "receptionist": "elandmall",
 "replyAt": "2025-01-15T14:17:13.973885-08:00",
 "content": "안녕하세요, \r\nAA몰입니다.\r\n\r\n담당부서측으로 내용 전달 완료 하였습니다.\r\n\r\n금일 내 확인될시 환불진행 하겠으나 , 평균 2영업일 소요되기에 익일까지 양해 바랍니다.\r\n\r\n감사합니다.\r\n",
 "answerId": 1027079048,
 "parentAnswerId": 0,
 "partnerTransferStatus": null,
 "partnerTransferCompleteReason": "NONE",
 "answerType": "vendor",
 "needAnswer": false
 }
 ],
 "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
 "buyerEmail": "",
 "buyerPhone": "+1(555)444-1234",
 "orderId": 100000********0,
 "orderDate": "2025-01-15T14:17:13.973885-08:00",
 "receiptCategory": "취소/반품 후단관리&gt;회수확인&gt;고객반송확인",
 "saleStartedAt": "2017-12-12",
 "saleEndedAt": "2099-12-30"
 }
 ],
 "pagination": {
 "currentPage": 1,
 "totalPages": 7,
 "totalElements": 13,
 "countPerPage": 2
 }
 }
}

# 06

Error codes

HTTP	Code	Message
400	HTTP_400	Bad Request

Error specification

HTTP	Type	Error message	Solution
400	400 (Check Request Parameter)	time interval needs to be less than or equal to 7 days， pattern should be yyyy-MM-dd	Make sure that the query period is 7 days or less.
400	400 (Check Request Parameter)	Invalid vendor ID	Make sure that the seller ID (vendorId) is correct.