(Common) Query contract list

# 01

Summary

# 02

Details

Available buyer market: Korea

An API to query the list of all the current contracts. Both non_contract_based and contract_based type contracts can be searched.

Path

GET/v2/providers/fms/apis/api/v2/vendors/{vendorId}/contract/list

Example endpoint

https://api-gateway.coupang.com/v2/providers/fms/apis/api/v2/vendors/A00012345/contract/list

# 03

Path parameters

Name	Type	Description
vendorId*	string	Seller ID Unique seller code issued by Coupang e.g. A00012345

# 04

Response body

Response message

Name	Type	Description
code	integer	Server response code
message	string	Server response message
httpStatus	integer	HTTP Status Code (Same value with server response code)
httpStatusMessage	string	HTTP Status Message (Same value with server response message)
errorMessage	string	This will contain detailed server failure reason message in all status except for HTTP Status 200
data	object	Contract list data
success data.success	boolean	Success or failure True or false
content data.content	object[]	Contract list
contractId data.content[].contractId	integer	Seller's contract ID e.g. 1, 2
vendorContractId data.content[].vendorContractId	integer	Seller's contract code (for Coupang's management purpose) e.g. -1, 1, 2
sellerId data.content[].sellerId	string	Seller ID e.g. A00012345
sellerShareRatio data.content[].sellerShareRatio	integer	Seller [funding] rate on the contract(%) e.g. 100
coupangShareRatio data.content[].coupangShareRatio	integer	Coupang [funding] rate on the contract(%) e.g. 100
gmvRatio data.content[].gmvRatio	integer	Monthly sales rate and monthly budget which are automatically generated based on sales in Coupang. e.g. 100.0
start data.content[].start	string	Start date and time e.g. 2018-01-22 00:00:00
end data.content[].end	string	End date and time e.g. 2018-12-31 23:59:59
type data.content[].type	string	Contract type e.g. CONTRACT_BASED, NON_CONTRACT_BASED
useBudget data.content[].useBudget	boolean
modifiedAt data.content[].modifiedAt	string	Final modification date and time e.g. 2017-09-25 11:40:01
modifiedBy data.content[].modifiedBy	string	Final editor ID
pagination data.pagination	string

Response Example

{
  "code": 200,
  "message": "OK",
  "httpStatus": 200,
  "httpStatusMessage": "OK",
  "errorMessage": "",
  "data": {
    "success": true,
    "content": [
      {
        "contractId": 1,
        "vendorContractId": 2,
        "sellerId": "A00012345",
        "sellerShareRatio": 100,
        "coupangShareRatio": 0,
        "gmvRatio": 10,
        "start": "2017-03-01 00:00:00",
        "end": "2017-12-31 23:59:59",
        "type": "CONTRACT_BASED",
        "useBudget": true,
        "modifiedAt": "2017-09-21 10:57:07",
        "modifiedBy": "pronimance"
      },
      {
        "contractId": 15,
        "vendorContractId": -1,
        "sellerId": "A00013264",
        "sellerShareRatio": 100,
        "coupangShareRatio": 0,
        "gmvRatio": 0,
        "start": "2017-09-25 11:40:01",
        "end": "2999-12-31 23:59:59",
        "type": "NON_CONTRACT_BASED",
        "useBudget": true,
        "modifiedAt": "2017-09-25 11:40:01",
        "modifiedBy": "bcho"
      },
      {
        "contractId": 9962,
        "vendorContractId": 7,
        "sellerId": "A00012345",
        "sellerShareRatio": 100,
        "coupangShareRatio": 0,
        "gmvRatio": 100,
        "start": "2018-01-22 00:00:00",
        "end": "2018-12-31 23:59:59",
        "type": "CONTRACT_BASED",
        "useBudget": true,
        "modifiedAt": "2018-01-22 16:07:10",
        "modifiedBy": "allie"
      }
    ],
    "pagination": null
  }
}

# 05

Error codes

HTTP	Code	Message
400	HTTP_400	Bad Request

Error specification

HTTP	Type	Error message	Solution
401	401 (check requested parameter)	Please check on seller information permission	Make sure proper vendorID was put in.