The nopCommerce API lets you do the following with the Product resource.
-
GET /api/products?fields=id,name,images
Receive a list of all Products -
GET /api/products/{id}?fields=id,name,images
Receive a single Product -
DELETE /api/products/{id}
Remove a Product from the database (mark as Deleted)
Retrieve all products
GET | /api/products |
---|---|
ids | A comma-separated list of order ids |
limit | Amount of results (default: 50) (maximum: 250) |
page | Page to show (default: 1) |
since_id | Restrict results to after the specified ID |
published_status |
|
vendor_name | Filter by product vendor |
category_id | Show only the products mapped to the specified category |
created_at_min | Show products created after date (format: 2014-04-25T16:15:47-04:00) |
created_at_max | Show products created before date (format: 2014-04-25T16:15:47-04:00) |
updated_at_min | Show products last updated after date (format: 2014-04-25T16:15:47-04:00) |
updated_at_max | Show products last updated before date (format: 2014-04-25T16:15:47-04:00) |
fields | Comma-separated list of fields to include in the response |
Get all products, showing only some attributes
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "1",
"name": "Build your own computer",
"images": [
{
"src": null,
"attachment":"/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDA"
},
{
"src": null,
"attachment":"/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDA"
}
]
},
{
"id": "2",
"name": "Digital Storm VANQUISH 3 Custom Performance PC",
"images": [
{
"src": null,
"attachment":"/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDA"
}
]
}
]
}
Get a list of specific products
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "1",
"visible_individually": true,
"name": "Build your own computer",
"short_description": "Build it",
"full_description": "<p>Fight back against cluttered workspaces with the stylish IBM zBC12 All-in-One desktop PC, featuring powerful computing resources and a stunning 20.1-inch widescreen display with stunning XBRITE-HiColor LCD technology. The black IBM zBC12 has a built-in microphone and MOTION EYE camera with face-tracking technology that allows for easy communication with friends and family. And it has a built-in DVD burner and Sony's Movie Store software so you can create a digital entertainment library for personal viewing at your convenience. Easy to setup and even easier to use, this JS-series All-in-One includes an elegantly designed keyboard and a USB mouse.</p>",
"show_on_home_page": true,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 0,
"not_approved_rating_sum": 0,
"approved_total_reviews": 0,
"not_approved_total_reviews": 0,
"sku": "COMP_CUST",
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": false,
"max_number_of_downloads": 0,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 0,
"recurring_total_cycles": 0,
"is_rental": false,
"rental_price_length": 0,
"is_ship_enabled": true,
"is_free_shipping": true,
"ship_separately": false,
"additional_shipping_charge": 0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": true,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 1200,
"old_price": 0,
"product_cost": 0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0,
"maximum_customer_entered_price": 0,
"baseprice_enabled": false,
"baseprice_amount": 0,
"baseprice_base_amount": 0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 2,
"length": 2,
"width": 2,
"height": 2,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-09-30T08:56:19.107",
"updated_on_utc": "2016-09-30T08:56:19.107",
"product_type": "SimpleProduct",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [
{
"src": null,
"attachment": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAcFBQYFBAcGBQY"
},
{
"src": null,
"attachment": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAcFBQYFBAcGBQYI"
}
],
"tags": [
"computer",
"awesome"
],
"vendor_id": 0,
"se_name": null
},
{
"id": "2",
"visible_individually": true,
"name": "Digital Storm VANQUISH 3 Custom Performance PC",
"short_description": "Digital Storm Vanquish 3 Desktop PC",
"full_description": "<p>Blow the doors off today’s most demanding games with maximum detail, speed, and power for an immersive gaming experience without breaking the bank.</p><p>Stay ahead of the competition, VANQUISH 3 is fully equipped to easily handle future upgrades, keeping your system on the cutting edge for years to come.</p><p>Each system is put through an extensive stress test, ensuring you experience zero bottlenecks and get the maximum performance from your hardware.</p>",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 4,
"not_approved_rating_sum": 0,
"approved_total_reviews": 1,
"not_approved_total_reviews": 0,
"sku": "DS_VA3_PC",
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": false,
"max_number_of_downloads": 0,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 0,
"recurring_total_cycles": 0,
"is_rental": false,
"rental_price_length": 0,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": true,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 1259,
"old_price": 0,
"product_cost": 0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0,
"maximum_customer_entered_price": 0,
"baseprice_enabled": false,
"baseprice_amount": 0,
"baseprice_base_amount": 0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 7,
"length": 7,
"width": 7,
"height": 7,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-09-30T08:56:19.43",
"updated_on_utc": "2016-09-30T08:56:19.43",
"product_type": "SimpleProduct",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [
{
"src": null,
"attachment": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAcFBQYFB"
}
],
"tags": [
"cool",
"computer"
],
"vendor_id": 0,
"se_name": null
}
]
}
Get all products after the specified ID
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "2",
"visible_individually": true,
"name": "Digital Storm VANQUISH 3 Custom Performance PC",
"short_description": "Digital Storm Vanquish 3 Desktop PC",
"full_description": "<p>Blow the doors off today’s most demanding games with maximum detail, speed, and power for an immersive gaming experience without breaking the bank.</p><p>Stay ahead of the competition, VANQUISH 3 is fully equipped to easily handle future upgrades, keeping your system on the cutting edge for years to come.</p><p>Each system is put through an extensive stress test, ensuring you experience zero bottlenecks and get the maximum performance from your hardware.</p>",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 4,
"not_approved_rating_sum": 0,
"approved_total_reviews": 1,
"not_approved_total_reviews": 0,
"sku": "DS_VA3_PC",
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": false,
"max_number_of_downloads": 0,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 0,
"recurring_total_cycles": 0,
"is_rental": false,
"rental_price_length": 0,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": true,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 1259,
"old_price": 0,
"product_cost": 0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0,
"maximum_customer_entered_price": 0,
"baseprice_enabled": false,
"baseprice_amount": 0,
"baseprice_base_amount": 0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 7,
"length": 7,
"width": 7,
"height": 7,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-09-30T08:56:19.43",
"updated_on_utc": "2016-09-30T08:56:19.43",
"product_type": "SimpleProduct",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [
{
"src": null,
"attachment": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAcFBQYFB"
}
],
"tags": [
"cool",
"computer"
],
"vendor_id": 0,
"se_name": null
}
]
}
Fetches all products that belong to a certain category
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "4",
"name": "Apple MacBook Pro 13-inch"
},
{
"id": "5",
"name": "Asus N551JK-XO076H Laptop"
},
{
"id": "6",
"name": "Samsung Series 9 NP900X4C Premium Ultrabook"
},
{
"id": "7",
"name": "HP Spectre XT Pro UltraBook"
},
{
"id": "8",
"name": "HP Envy 6-1180ca 15.6-Inch Sleekbook"
},
{
"id": "9",
"name": "Lenovo Thinkpad X1 Carbon Laptop"
}
]
}
Get a count of all products
GET | /api/products/count |
---|---|
published_status |
|
vendor_name | Filter by product vendor |
category_id | Show only the products mapped to the specified category |
created_at_min | Show products created after date (format: 2014-04-25T16:15:47-04:00) |
created_at_max | Show products created before date (format: 2014-04-25T16:15:47-04:00) |
updated_at_min | Show products last updated after date (format: 2014-04-25T16:15:47-04:00) |
updated_at_max | Show products last updated before date (format: 2014-04-25T16:15:47-04:00) |
Count all products
Response
HTTP/1.1 200 OK
{
"count": 45
}
Count all products belonging to a certain category
Response
HTTP/1.1 200 OK
{
"count": 6
}
Get a single product
GET | /api/products/{id} |
---|---|
fields | Comma-separated list of fields to include in the response |
Get a single product by id
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "2",
"visible_individually": true,
"name": "Digital Storm VANQUISH 3 Custom Performance PC",
"short_description": "Digital Storm Vanquish 3 Desktop PC",
"full_description": "<p>Blow the doors off today’s most demanding games with maximum detail, speed, and power for an immersive gaming experience without breaking the bank.</p><p>Stay ahead of the competition, VANQUISH 3 is fully equipped to easily handle future upgrades, keeping your system on the cutting edge for years to come.</p><p>Each system is put through an extensive stress test, ensuring you experience zero bottlenecks and get the maximum performance from your hardware.</p>",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 4,
"not_approved_rating_sum": 0,
"approved_total_reviews": 1,
"not_approved_total_reviews": 0,
"sku": "DS_VA3_PC",
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": false,
"max_number_of_downloads": 0,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 0,
"recurring_total_cycles": 0,
"is_rental": false,
"rental_price_length": 0,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": true,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 1259,
"old_price": 0,
"product_cost": 0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0,
"maximum_customer_entered_price": 0,
"baseprice_enabled": false,
"baseprice_amount": 0,
"baseprice_base_amount": 0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 7,
"length": 7,
"width": 7,
"height": 7,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-09-30T08:56:19.43",
"updated_on_utc": "2016-09-30T08:56:19.43",
"product_type": "SimpleProduct",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [
{
"src": null,
"attachment": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAcFBQYFB"
}
],
"tags": [
"cool",
"computer"
],
"vendor_id": 0,
"se_name": null
}
]
}
Get a single product with id 2 and show only the id and the name in the response
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "2",
"name": "Digital Storm VANQUISH 3 Custom Performance PC"
}
]
}
Create a new product
POST /api/products
{
"product": {
"name": ""
}
}
Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"Name": [
"'Name' must not be empty.",
"name is required"
]
}
}
POST /api/product
{
"product": {
"name": "Skate Banana",
"full_description": "<strong>Great snowboard!</strong>",
"short_description": "TWIN ALL TERRAIN FUN"
}
}
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "47",
"visible_individually": true,
"name": "Skate Banana",
"short_description": "TWIN ALL TERRAIN FUN",
"full_description": "<strong>Great snowboard!</strong>",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 0,
"not_approved_rating_sum": 0,
"approved_total_reviews": 0,
"not_approved_total_reviews": 0,
"sku": null,
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": true,
"max_number_of_downloads": 10,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 100,
"recurring_total_cycles": 10,
"is_rental": false,
"rental_price_length": 1,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0.0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": false,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 0.0,
"old_price": 0.0,
"product_cost": 0.0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0.0,
"maximum_customer_entered_price": 1000.0,
"baseprice_enabled": false,
"baseprice_amount": 0.0,
"baseprice_base_amount": 0.0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 1.00000000,
"length": 0.0,
"width": 0.0,
"height": 0.0,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-10-15T16:08:30.1363088Z",
"updated_on_utc": "2016-10-15T16:08:30.1363088Z",
"product_type": "0",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [],
"tags": [],
"vendor_id": 0,
"se_name": "skate-banana"
}
]
}
POST /api/products
{
"product": {
"name": "Skate Banana",
"full_description": "<strong>Great snowboard!</strong>",
"short_description": "TWIN ALL TERRAIN FUN",
"images": [
{
"src": "http://cdn.lib-tech.com/wp-content/uploads/2016/07/2016-2017-Lib-Tech-Skate-Banana-Yellow-Snowboard-800x800.png"
}
]
}
}
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "48",
"visible_individually": true,
"name": "Skate Banana",
"short_description": "TWIN ALL TERRAIN FUN",
"full_description": "<strong>Great snowboard!</strong>",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 0,
"not_approved_rating_sum": 0,
"approved_total_reviews": 0,
"not_approved_total_reviews": 0,
"sku": null,
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": true,
"max_number_of_downloads": 10,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 100,
"recurring_total_cycles": 10,
"is_rental": false,
"rental_price_length": 1,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0.0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": false,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 0.0,
"old_price": 0.0,
"product_cost": 0.0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0.0,
"maximum_customer_entered_price": 1000.0,
"baseprice_enabled": false,
"baseprice_amount": 0.0,
"baseprice_base_amount": 0.0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 1.00000000,
"length": 0.0,
"width": 0.0,
"height": 0.0,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-10-15T16:23:36.0206655Z",
"updated_on_utc": "2016-10-15T16:23:36.0206655Z",
"product_type": "0",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [
{
"src": null,
"attachment": "iVBORw0KGgoAAAANSUhEUgAAAyAAAAMgCAYAAADbcAZoAA"
}
],
"tags": [],
"vendor_id": 0,
"se_name": "skate-banana-2"
}
]
}
POST /api/products
{
"product": {
"name": "Skate Banana",
"full_description": "<strong>Great snowboard!</strong>",
"short_description": "TWIN ALL TERRAIN FUN",
"images": [
{
"attachment": "iVBORw0KGgoAAAANSUhEUgAAAyAAAAMgCAYAAADbcAZoAA"
}
]
}
}
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "49",
"visible_individually": true,
"name": "Skate Banana",
"short_description": "TWIN ALL TERRAIN FUN",
"full_description": "<strong>Great snowboard!</strong>",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 0,
"not_approved_rating_sum": 0,
"approved_total_reviews": 0,
"not_approved_total_reviews": 0,
"sku": null,
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": true,
"max_number_of_downloads": 10,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 100,
"recurring_total_cycles": 10,
"is_rental": false,
"rental_price_length": 1,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0.0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": false,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 0.0,
"old_price": 0.0,
"product_cost": 0.0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0.0,
"maximum_customer_entered_price": 1000.0,
"baseprice_enabled": false,
"baseprice_amount": 0.0,
"baseprice_base_amount": 0.0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 1.00000000,
"length": 0.0,
"width": 0.0,
"height": 0.0,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-10-15T16:23:36.0206655Z",
"updated_on_utc": "2016-10-15T16:23:36.0206655Z",
"product_type": "0",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [
{
"src": null,
"attachment": "iVBORw0KGgoAAAANSUhEUgAAAyAAAAMgCAYAAADbcAZoAA"
}
],
"tags": [],
"vendor_id": 0,
"se_name": "skate-banana-3"
}
]
}
POST /api/products
{
"product": {
"name": "Skate Banana",
"full_description": "<strong>Great snowboard!</strong>",
"short_description": "TWIN ALL TERRAIN FUN",
"published": false
}
}
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "50",
"visible_individually": true,
"name": "Skate Banana",
"short_description": "TWIN ALL TERRAIN FUN",
"full_description": "<strong>Great snowboard!</strong>",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 0,
"not_approved_rating_sum": 0,
"approved_total_reviews": 0,
"not_approved_total_reviews": 0,
"sku": null,
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": true,
"max_number_of_downloads": 10,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 100,
"recurring_total_cycles": 10,
"is_rental": false,
"rental_price_length": 1,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0.0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": false,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 0.0,
"old_price": 0.0,
"product_cost": 0.0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0.0,
"maximum_customer_entered_price": 1000.0,
"baseprice_enabled": false,
"baseprice_amount": 0.0,
"baseprice_base_amount": 0.0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 1.00000000,
"length": 0.0,
"width": 0.0,
"height": 0.0,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": false,
"deleted": false,
"created_on_utc": "2016-10-15T17:00:31.5466951Z",
"updated_on_utc": "2016-10-15T17:00:31.5466951Z",
"product_type": "0",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [],
"tags": [],
"vendor_id": 0,
"se_name": "skate-banana-4"
}
]
}
POST /api/products
{
"product": {
"name": "Skate Banana",
"attributes": [
{
"product_attribute_id":8,
"product_attribute_name": "Size",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 1,
"display_order": 0,
"default_value": null,
"attribute_control_type_name": "DropdownList",
"attribute_values": [
{
"type_id": 0,
"associated_product_id": 0,
"name": "28",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 0,
"is_pre_selected": false,
"display_order": 1,
"product_image_id": null,
"type": "Simple"
},
{
"type_id": 0,
"associated_product_id": 0,
"name": "29",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 5,
"is_pre_selected": false,
"display_order": 2,
"product_image_id": null,
"type": "Simple"
}
]
},
{
"product_attribute_id": 3,
"product_attribute_name": "Custom Text",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 4,
"display_order": 0,
"default_value": null,
"attribute_control_type_name": "Textbox"
},
{
"product_attribute_id": 1,
"product_attribute_name": "Color",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 1,
"display_order": 0,
"default_value": null,
"attribute_control_type_name": "DropdownList",
"attribute_values": [
{
"type_id": 0,
"associated_product_id": 0,
"name": "Red",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 0,
"is_pre_selected": false,
"display_order": 1,
"product_image_id": null,
"type": "Simple"
}
]
}
]
}
}
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "50",
"visible_individually": true,
"name": "Skate Banana",
"attributes": [
{
"id": 45,
"product_attribute_id":8,
"product_attribute_name": "Size",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 1,
"display_order": 0,
"default_value": null,
"attribute_control_type_name": "DropdownList",
"attribute_values": [
{
"id": 55,
"type_id": 0,
"associated_product_id": 0,
"name": "28",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 0,
"is_pre_selected": false,
"display_order": 1,
"product_image_id": null,
"type": "Simple"
},
{
"id": 56,
"type_id": 0,
"associated_product_id": 0,
"name": "29",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 5,
"is_pre_selected": false,
"display_order": 2,
"product_image_id": null,
"type": "Simple"
}
]
},
{
"id": 46,
"product_attribute_id": 3,
"product_attribute_name": "Custom Text",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 4,
"display_order": 0,
"default_value": null,
"attribute_control_type_name": "Textbox",
"attribute_values":[]
},
{
"id": 47,
"product_attribute_id": 1,
"product_attribute_name": "Color",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 1,
"display_order": 0,
"default_value": null,
"attribute_control_type_name": "DropdownList",
"attribute_values": [
{
"id": 57,
"type_id": 0,
"associated_product_id": 0,
"name": "Red",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 0,
"is_pre_selected": false,
"display_order": 1,
"product_image_id": null,
"type": "Simple"
}
]
}
],
"short_description": "",
"full_description": "",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 0,
"not_approved_rating_sum": 0,
"approved_total_reviews": 0,
"not_approved_total_reviews": 0,
"sku": null,
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": true,
"max_number_of_downloads": 10,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 100,
"recurring_total_cycles": 10,
"is_rental": false,
"rental_price_length": 1,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0.0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": false,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 0.0,
"old_price": 0.0,
"product_cost": 0.0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0.0,
"maximum_customer_entered_price": 1000.0,
"baseprice_enabled": false,
"baseprice_amount": 0.0,
"baseprice_base_amount": 0.0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 1.00000000,
"length": 0.0,
"width": 0.0,
"height": 0.0,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-10-15T17:00:31.5466951Z",
"updated_on_utc": "2016-10-15T17:00:31.5466951Z",
"product_type": "0",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [],
"tags": [],
"vendor_id": 0,
"se_name": "skate-banana-4"
}
]
}
Update a product
POST /api/products/49
{
"product": {
"name": "Updated Skate Banana",
"short_description": "Updated TWIN ALL TERRAIN FUN"
}
}
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "49",
"visible_individually": true,
"name": "Updated Skate Banana",
"short_description": "Updated TWIN ALL TERRAIN FUN",
"full_description": "<strong>Great snowboard!</strong>",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 0,
"not_approved_rating_sum": 0,
"approved_total_reviews": 0,
"not_approved_total_reviews": 0,
"sku": null,
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": true,
"max_number_of_downloads": 10,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 100,
"recurring_total_cycles": 10,
"is_rental": false,
"rental_price_length": 1,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0.0000,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": false,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 0.0000,
"old_price": 0.0000,
"product_cost": 0.0000,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0.0000,
"maximum_customer_entered_price": 1000.0000,
"baseprice_enabled": false,
"baseprice_amount": 0.0000,
"baseprice_base_amount": 0.0000,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 1.0000,
"length": 0.0000,
"width": 0.0000,
"height": 0.0000,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-10-15T16:44:20.427",
"updated_on_utc": "2016-10-15T17:16:32.477802Z",
"product_type": "0",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [],
"tags": [],
"vendor_id": 0,
"se_name": "updated-skate-banana"
}
]
}
PUT /api/products/50
{
"product": {
"attributes": [
{
"id": 45,
"display_order": 1,
},
{
"id": 46,
"display_order": 3,
},
{
"id": 47,
"display_order": 2,
}
]
}
}
Response
HTTP/1.1 200 OK
{
"products": [
{
"id": "50",
"visible_individually": true,
"name": "Skate Banana",
"attributes": [
{
"id": 45,
"product_attribute_id":8,
"product_attribute_name": "Size",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 1,
"display_order": 1,
"default_value": null,
"attribute_control_type_name": "DropdownList",
"attribute_values": [
{
"id": 55,
"type_id": 0,
"associated_product_id": 0,
"name": "28",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 0,
"is_pre_selected": false,
"display_order": 1,
"product_image_id": null,
"type": "Simple"
},
{
"id": 56,
"type_id": 0,
"associated_product_id": 0,
"name": "29",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 5,
"is_pre_selected": false,
"display_order": 2,
"product_image_id": null,
"type": "Simple"
}
]
},
{
"id": 46,
"product_attribute_id": 3,
"product_attribute_name": "Custom Text",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 4,
"display_order": 3,
"default_value": null,
"attribute_control_type_name": "Textbox",
"attribute_values":[]
},
{
"id": 47,
"product_attribute_id": 1,
"product_attribute_name": "Color",
"text_prompt": null,
"is_required": true,
"attribute_control_type_id": 1,
"display_order": 2,
"default_value": null,
"attribute_control_type_name": "DropdownList",
"attribute_values": [
{
"id": 57,
"type_id": 0,
"associated_product_id": 0,
"name": "Red",
"color_squares_rgb": null,
"image_squares_image": null,
"price_adjustment": 0.0000,
"weight_adjustment": 0.0000,
"cost": 0.0000,
"quantity": 0,
"is_pre_selected": false,
"display_order": 1,
"product_image_id": null,
"type": "Simple"
}
]
}
],
"short_description": "",
"full_description": "",
"show_on_home_page": false,
"meta_keywords": null,
"meta_description": null,
"meta_title": null,
"allow_customer_reviews": true,
"approved_rating_sum": 0,
"not_approved_rating_sum": 0,
"approved_total_reviews": 0,
"not_approved_total_reviews": 0,
"sku": null,
"manufacturer_part_number": null,
"gtin": null,
"is_gift_card": false,
"require_other_products": false,
"automatically_add_required_products": false,
"is_download": false,
"unlimited_downloads": true,
"max_number_of_downloads": 10,
"download_expiration_days": null,
"has_sample_download": false,
"has_user_agreement": false,
"is_recurring": false,
"recurring_cycle_length": 100,
"recurring_total_cycles": 10,
"is_rental": false,
"rental_price_length": 1,
"is_ship_enabled": true,
"is_free_shipping": false,
"ship_separately": false,
"additional_shipping_charge": 0.0,
"is_tax_exempt": false,
"is_telecommunications_or_broadcasting_or_electronic_services": false,
"use_multiple_warehouses": false,
"stock_quantity": 10000,
"display_stock_availability": false,
"display_stock_quantity": false,
"min_stock_quantity": 0,
"notify_admin_for_quantity_below": 1,
"allow_back_in_stock_subscriptions": false,
"order_minimum_quantity": 1,
"order_maximum_quantity": 10000,
"allowed_quantities": null,
"allow_adding_only_existing_attribute_combinations": false,
"disable_buy_button": false,
"disable_wishlist_button": false,
"available_for_pre_order": false,
"pre_order_availability_start_date_time_utc": null,
"call_for_price": false,
"price": 0.0,
"old_price": 0.0,
"product_cost": 0.0,
"special_price": null,
"special_price_start_date_time_utc": null,
"special_price_end_date_time_utc": null,
"customer_enters_price": false,
"minimum_customer_entered_price": 0.0,
"maximum_customer_entered_price": 1000.0,
"baseprice_enabled": false,
"baseprice_amount": 0.0,
"baseprice_base_amount": 0.0,
"has_tier_prices": false,
"has_discounts_applied": false,
"weight": 1.00000000,
"length": 0.0,
"width": 0.0,
"height": 0.0,
"available_start_date_time_utc": null,
"available_end_date_time_utc": null,
"display_order": 0,
"published": true,
"deleted": false,
"created_on_utc": "2016-10-15T17:00:31.5466951Z",
"updated_on_utc": "2016-10-15T17:00:31.5466951Z",
"product_type": "0",
"role_ids": [],
"discount_ids": [],
"store_ids": [],
"manufacturer_ids": [],
"images": [],
"tags": [],
"vendor_id": 0,
"se_name": "skate-banana-4"
}
]
}
Mark a product as Deleted.
DELETE /api/products/50
Response
HTTP/1.1 200 OK
{}