Upgrade to ChromeUpgrade to FirefoxUpgrade to Internet ExplorerUpgrade to Safari

Catalogue

Get product catalogue

Retrieves information about the different products available in a given country

URL

https://api.pwinty.com/v2.2/Catalogue/{countryCode}/{qualityLevel}

Method

GET

Parameters

  • countryCode Two letter country code of the country
  • qualityLevel Quality level you'd like the catalogue for (Valid values are Pro or Standard)

Sample JSON response

{
    "country": "United Kingdom",
    "countryCode": "GB",
    "qualityLevel" : "Pro",
    "items" : [
        {
            "description" : "10x12 Print",
            "imageHorizontalSize": 10,
            "imageVerticalSize": 12,
            "fullProductHorizontalSize": 10,
            "fullProductVerticalSize": 12,
            "name": "10x12",
            "priceGBP": 150,
            "priceUSD": 350,
            "recommendedHorizontalResolution" : 1500,
            "recommendedVerticalResolution" : 1800,
            "sizeUnits": "inches",
            "shippingBand" : "Prints",
            "attributes" : [
                {
                    "name" : "finish",
                    "validValues" : ["matte","glossy"]
                }
            ]
        }, { ... 
        }
    ],
    "shippingRates" : [
        {
           "band" : "Canvas",
           "description": "Canvas tracked- UPS",
           "isTracked": true,
           "priceGBP": 700,
           "priceUSD": 1100
        },
        {
           ...
        }
    ]
}

Return value definitions

Field Description
countryCode Two letter country code of the catalogue
country Name of the country
qualityLevel Quality Level of the catalogue (either Pro or Standard)
items Array of items available in the catalogue
shippingRates Array of shipping rates available in the catalogue
 

Catalogue Item

Field Description
name Name of the item (serves as the key when adding items to order)
description Description of the item
imageHorizontalSize Horizontal size of the printed part of the item
imageVerticalSize Vertical size of the printed part of the item
fullProductHorizontalSize Horizontal size of the whole item (including any mounting or frame)
fullProductVerticalSize Vertical size of the whole item (including any mounting or frame)
sizeUnits Whether horizontalSize and verticalSize are in inches or cm
priceGBP Price in British pence of the item
priceUSD Price in US cents of the item
recommendedHorizontalResolution Recommended horizontal resolution of source image
recommendedVerticalResolution Recommended vertical resolution of source image
attributes Array of valid attributes for the item. Each attribute item has a name, and an array of valid values.
 

Shipping Rates

Field Description
band shipping band of the item (e.g. Prints, LargePrints, Canvas, FramedPrints)
description Description of the item
isTracked Whether this is a tracked service or not
priceGBP Price in British pence of the item
priceUSD Price in US cents of the item

Error

404 - Specificed country or qualityLevel was not found