Catalog
Product Offers
A Product Offer is a merchant's offering of a product. Since multiple merchants can be selling the same product, Violet provides you with each of the offers so that you can choose which suits your system best.
GET /catalog/offers/merchants/{merchant_id}
Query an individual merchant’s offers in a paginated format without top level product wrappers. API Reference: Get Offer by ID
Request
merchant_id
- ID of the merchant you are requesting product offers for
Optional Query Parameters:
page
- the current page, used in pagination.
size
- the number of products each page should contain, used in pagination.
base_currency
- the desired currency for the offer pricing to be presented in.
Curl
curl https://sandbox-api.violet.io/v1/catalog/offers/merchants/{merchant_id} \
-H "X-Violet-App-Id: your-app-id-here" \
-H "X-Violet-App-Secret: your-app-secret-here" \
-H "X-Violet-Token: your-token-here" \
Response
JSON
{
"content": [
{
"id": 10064,
"product_id": "0ff55c5cda7447118d6ae1c8395f8f11",
"external_id": "1525149073526",
"external_url": "https://violet-besties.myshopify.com/products/gopro-karma-quadcopter-with-hero6-black-white",
"name": "GoPro - Karma Quadcopter with HERO6 Black - White",
"description": "Ultra portable; includes GoPro HERO6 Black and detachable camera stabilizer; flying range up to 3280 ft; game-style controller with ultra bright touch display; grip handle included; built-in no-fly zones",
"source": "SHOPIFY",
"seller": "Violet-Besties",
"vendor": "GoPro",
"merchant_id": 10000,
"available": true,
"visible": true,
"min_price": 84999,
"max_price": 84999,
"commission_rate": 15.0,
"currency": "USD",
"source_category_name": "Unmanned_Aerial_Vehicles",
"meta": [],
"variants": [
{
"external_id": "2049150550134",
"name": "Color",
"visual": true,
"values": [
{
"external_id": "White",
"name": "White",
"sku_ids": [
10064
]
}
]
}
],
"skus": [
{
"id": 10064,
"offer_id": 10064,
"merchant_id": 10000,
"external_id": "13884047425654",
"name": "GoPro - Karma Quadcopter with HERO6 Black - White - White",
"in_stock": true,
"qty_available": 9999,
"inventory_tracked": true,
"sale_price": 84999,
"retail_price": 99999,
"currency": "USD",
"taxable": true,
"tax_type": "DEFAULT",
"albums": [],
"variant_values": [
{
"variant": "Color",
"value": "White"
}
],
"type": "PHYSICAL",
"status": "AVAILABLE",
"date_created": "2018-08-15T15:56:31+0000",
"date_last_modified": "2021-03-05T21:56:01+0000",
"sku_dimensions": {
"weight": 13.45,
"type": "SKU"
}
}
],
"albums": [
{
"id": 10064,
"parent_id": 10064,
"type": "OFFER",
"name": "Primary Album",
"media": [
{
"id": 10064,
"album_id": 10064,
"external_id": "4192655900790",
"url": "https://cdn.shopify.com/s/files/1/0057/6467/7750/products/6029300_ra.jpg",
"source_url": "https://cdn.shopify.com/s/files/1/0057/6467/7750/products/6029300_ra.jpg",
"type": "IMAGE",
"display_order": 1,
"primary": true
}
],
"primary_media": {
"id": 10064,
"album_id": 10064,
"external_id": "4192655900790",
"url": "https://cdn.shopify.com/s/files/1/0057/6467/7750/products/6029300_ra.jpg",
"source_url": "https://cdn.shopify.com/s/files/1/0057/6467/7750/products/6029300_ra.jpg",
"type": "IMAGE",
"display_order": 1,
"primary": true
}
}
],
"three_denabled": false,
"status": "AVAILABLE",
"date_created": "2018-08-15T15:56:31+0000",
"date_last_modified": "2021-03-05T21:56:01+0000"
}
],
"pageable": {
"sort": {
"unsorted": false,
"sorted": true,
"empty": false
},
"page_number": 0,
"page_size": 1,
"offset": 0,
"paged": true,
"unpaged": false
},
"total_elements": 110,
"last": false,
"total_pages": 110,
"sort": {
"unsorted": false,
"sorted": true,
"empty": false
},
"number_of_elements": 1,
"first": true,
"size": 1,
"number": 0,
"empty": false
}