Skip to content


Use this api to get the specified product details.

GET /openapi/product/master/v1/get

Request Parameters

Parameter Type Required Description
productId string true The product id in Ginee

Response Parameters

Name Type Description
productId string Product id in Ginee
name string Product name
fullCategoryId array(string) Full category id
fullCategoryName array(string) Full category name
masterVariationType string Master variation type (NORMAL,BUNDLE)
masterProductStatus string Master product status,please refer to Product Status for details
images array(string) images
delivery Delivery Delivery info
costInfo CostInfo Cost info
shortDescription string Short description
description string Description
brand string brand
saleStatus string Product sale status,please refer to Sale Status for details
genieProductCondition string Ginee product Condition (NEW,USED)
variantOptions array(object) Variant options,See VariantOption Info
variations array(object) Master variation Detail,See MasterVariation Info
extraInfo object Extra Info,See Extra Info
createDatetime UTC timestamp Create date time
updateDatetime UTC timestamp Update date time
minPurchase integer Minimum purchase quantity
skusDeletable boolean Whether the SKU can be deleted
spu string spu

Variant Option

Parameter Type Required Description
name string true Variant name, such as color, size
values array(string) true The value of the variant, such as red and yellow and size

Master Variation

Parameter Type Required Description
optionValues array(string) false Variant value, such as red code and L code
sellingPrice object true The sellingPrice is required and less than 1000000000,See Price
averageCostPrice object false Average Cost Price,See Price
sku string true Sku is required and less than 200
images array(string) false Picture of the SKU
stock object true See StockDetail Info
purchasePrice object false The purchase Price is required when type is not a BUNDLE and is less than 1000000000,See Price
bundleVariations object false If it is a combination of goods, information about the SKUS bundled with the combination SKUS is displayed,See BundleVariation Info
barcode string false Barcode only supports letters, numbers and -_ ,Barcode is optional, but the unique value will be verified,Less than 128 characters in length
status string true Available values: ACTIVE、DISABLED、DELETED

Bundle Variation

Parameter Type Required Description
quantity integer false Variation quantity
bundleVariationId string false Bundle Variation Id,Obtained via ListMasterProduct endpoint

Stock Detail

Parameter Type Required Description
availableStock integer true Available stock,between 1 and 999999
safetyStock integer false Safety Stock
safetyAlert boolean false Safety Alert

Product Extra

Parameter Type Required Description
preOrder object false See PreOrder Info
hasShelfLife boolean false Has Shelf Life,true or false
shelfLifePeriod integer false Shelf Life Period
additionInfo object false Additional information See Additional Info


Parameter Type Required Description
remark1 string false remark
remark2 string false remark
remark3 string false remark

Pre Order

Parameter Type Required Description
settingType string false Pre order setting type (PRODUCT_ON,INHERIT_SHOP,PRODUCT_OFF)
timeToShip integer false Number of hours, for example 12
timeUnit string false Purchasing time unit (HOUR,DAY,WORK_DAY,WEEK,MONTH)


Parameter Type Required Description
amount bigDecimal true Amount,less than 1000000000
currencyCode string true Currency code,For example: ID,please refer to Country Abbreviation for details

Request Example


curl --location --request GET '{Ginee Host}/openapi/product/master/v1/get?productId=MP60C1F538EE3588000147F0D2' \
--header 'Content-Type: application/json' \
--header 'X-Advai-Country: ID' \
--header 'Authorization: 2aedf7919e5e6cb4:n0IECNXloTKCTSSxeBEYhzmeVClHmgvw4ruI3W2f9eY=' \


    "code": "SUCCESS",
    "message": "成功",
    "data": {
        "productId": "MP60C1F538EE3588000147F0D2",
        "name": "test00222222222222222222",
        "fullCategoryId": [],
        "fullCategoryName": [],
        "masterVariationType": "NORMAL",
        "masterProductStatus": "PENDING_REVIEW",
        "images": [
        "delivery": {
            "length": 1,
            "width": 1,
            "height": 1,
            "lengthUnit": "cm",
            "weight": 1000,
            "weightUnit": "g",
            "barcode": null
        "costInfo": {
            "sourceUrl": null,
            "purchasingTime": null,
            "purchasingTimeUnit": null,
            "salesTax": {
                "amount": 0,
                "currencyCode": "IDR"
        "shortDescription": null,
        "description": "1test002222222222222",
        "brand": null,
        "saleStatus": "FOR_SALE",
        "genieProductCondition": "NEW",
        "variantOptions": [],
        "variations": [
                "id": "MV60C1F538EE3588000147F0D3",
                "productName": "test00222222222222222222",
                "optionValues": [
                "sellingPrice": {
                    "amount": 100.000000,
                    "currencyCode": "IDR"
                "averageCostPrice": {
                    "amount": 0.000000,
                    "currencyCode": "IDR"
                "sku": "SHP5454",
                "images": [
                "status": "ACTIVE",
                "createFrom": null,
                "variationSkusToBind": [],
                "stock": {
                    "warehouseStock": 0,
                    "spareStock": 0,
                    "availableStock": 110,
                    "safetyStock": 0,
                    "safetyAlert": false
                "purchasePrice": null,
                "type": "NORMAL",
                "bundleVariations": null,
                "barcode": null,
                "stockTagStatus": {
                    "warehouseStatus": false,
                    "bundleStatus": null,
                    "stockSyncStatus": true
                "boundChannelVariationCount": 1
        "extraInfo": {
            "warranty": {
                "type": null,
                "period": null
            "preOrder": {
                "settingType": "PRODUCT_OFF",
                "timeToShip": null,
                "timeUnit": null
            "hasShelfLife": false,
            "shelfLifePeriod": null,
            "storageRestriction": null,
            "deliveryRestriction": null
        "createDatetime": "2021-06-10T11:19:20Z",
        "updateDatetime": "2021-06-10T11:19:20Z",
        "minPurchase": null,
        "skusDeletable": false,
        "spu": "sga"
    "extra": null,
    "pricingStrategy": "PAY"

Invalid parameters

    "code": "PARAMETER_ERROR",
    "message": "error message",
    "data": null,
    "extra": null


You need to check the code to see if the operation was successful. If failed, see message for detail reason.