Fetching Collections From a Platform

​

Relay Get Collections

Using Relay the collection data in an external commerce platform is translated into a single common schema, the Violet Collection, in real time. You can fetch these collections using the Relay Get Collections endpoint.

Get Collections

GET /v1/relay/merchants/{merchant_id}/collections

Optional Query Parameters

The following query parameters can be used with Get Collections requests.

size - use the size field in your Relay request to define the total number of results. When no value is provided, the results will be limited to 20. The upper bound of this field will conform to the limitations of the external commerce platform.

page - when interacting with external commerce platforms that use page-based pagination, used the page field in your Relay request to define what page of results you want to retrieve. When no value is provided, the first page of results based on the value of size will be returned.

next_page_cursor - when interacting with external commerce platforms that use cursor-based pagination, used the next_page_cursor field in your Relay request to define that page of results you want to retrieve. For these platforms, the response body from the request will also include a next_page_cursor field which will provide the cursor for the next page, if any.

Sample Request for first page of 20 Shopify Collections.

GET /v1/relay/merchants/{merchant_id}/collections?size=20

{
    "content": [
        {
            "external_id": "281893699720",
            "merchant_id": 10069,
            "name": "Auto clothing",
            "handle": "auto-clothing",
            "description": "Auto",
            "status": "ACTIVE",
            "type": "AUTOMATED"
        },
        {
            "external_id": "282385645704",
            "merchant_id": 10069,
            "name": "Green",
            "handle": "green",
            "description": "Green",
            "status": "ACTIVE",
            "type": "CUSTOM",
            "media": {
                "source_url": "https://cdn.shopify.com/s/files/1/0582/6022/6184/collections/Sample.webp?v=1707250610",
                "height": 576,
                "width": 1024
            }
        }
    ],
    "last": true,
    "number_of_elements": 2,
    "empty": false
}

​

Supported Platforms

• Shopify