​
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
}

Was this page helpful?