Get a Product
GET
Get by ID
https://api.moltin.com/v2/products/:id
This endpoint retrieves an existing Product by ID.
Path Parameters:
Name | Required | Type | Description |
---|---|---|---|
id | Required | string | The ID for the requested Product. |
Headers:
Name | Required | Type | Description |
---|---|---|---|
Authorization | Required | string | The Bearer token to grant access to the API. Implicit Bearer token only returns products with live status; products with draft status won’t be included. |
Query Parameters:
Name | Required | Type | Description |
---|---|---|---|
include | Optional | string | main_image , files , brands , categories , collections |
200 OK
{
"data": {
"type": "product",
"id": "9eda5ba0-4f4a-4074-8547-ccb05d1b5981",
"name": "Crown",
"slug": "crown",
"sku": "CWLP100BLK",
"manage_stock": true,
"description": "Abstract, sculptural, refined and edgy with a modern twist. Its symmetrical, spoked structure generates a clever geometric presence, which works well in a contemporary environment.",
"price": [
{
"amount": 47500,
"currency": "USD",
"includes_tax": true
}
],
"status": "live",
"commodity_type": "physical",
"meta": {
"timestamps": {
"created_at": "2017-06-19T14:58:42+00:00",
"updated_at": "2018-04-10T09:12:05+00:00"
},
"display_price": {
"with_tax": {
"amount": 47500,
"currency": "USD",
"formatted": "$475.00"
},
"without_tax": {
"amount": 47500,
"currency": "USD",
"formatted": "$475.00"
}
},
"stock": {
"level": 500,
"availability": "in-stock"
},
"variation_matrix": []
},
"relationships": {
"files": {
"data": [
{
"type": "file",
"id": "7cc08cbb-256e-4271-9b01-d03a9fac9f0a"
}
]
},
"categories": {
"data": [
{
"type": "category",
"id": "a636c261-0259-4975-ac8e-77246ec9cfe0"
}
]
},
"main_image": {
"data": {
"type": "main_image",
"id": "7cc08cbb-256e-4271-9b01-d03a9fac9f0a"
}
}
},
"material": null, // Custom flow field
"max_watt": null, // Custom flow field
"bulb_qty": null, // Custom flow field
"bulb": null, // Custom flow field
"new": null, // Custom flow field
"on_sale": null, // Custom flow field
"background_colour": "#d9d9d9", // Custom flow field
"finish": "test" // Custom flow field
}
}
note
There is only a display_price in your response if the product you are requesting has a price in the currency you are using as a header. If a header is not passed, the product must have a price in your default currency.
curl -X GET https://api.moltin.com/v2/products/:id \
-H "Authorization: Bearer XXXX" \
const MoltinGateway = require('@moltin/sdk').gateway
const Moltin = MoltinGateway({
client_id: 'X'
})
const id = 'XXXX'
Moltin.Products.Get(id).then(product => {
// Do something
})
const { MoltinClient } = require('@moltin/request')
const client = new MoltinClient({
client_id: 'X'
})
const id = 'XXXX'
client
.get(`products/${id}`)
.then(product => {
// Do something...
})
.catch(console.error)