General

In our terminology, a product type represents the pure piece or apparel, e.g. a T-shirt, as we get it from our supplier, e.g. American Apparel. A typical product type, e.g. a yellow T-shirt from American Apparel, is illustrated in the picture below. A product type has the following characteristics:


ProductType Images

For product types, we deliver the following images:

Resource

While a list resource exists it is recommended to retrieve only the ProductType that is required to display a product. In order to internationalize the returned payload it is possible to specify a locale query parameter.

MethodURLExample
GET/api/v1/shops/<shopId>/productTypes/<productTypeId>https://api.spreadshirt.net/api/v1/shops/100488332/productTypes/812?mediaType=json


The returned payload provides you with extension information about the given ProductType:

{
   "href":"https://api.spreadshirt.net/api/v1/shops/100488332/productTypes/812",
   "id":"812",
   "name":"Men’s Premium T-Shirt",
   "shortDescription":"Classic cut T-shirt for men, 100% cotton. Brand: Spreadshirt",
   "description":"The Spreadshirt Collection stands for best-possible print results on top-quality products. A huge range of sizes makes sure that our gear fits everyone, big and small alike. \r\nWhat’s more, the Premium T-shirt offers an sheer infinite choice of combination opportunity with other items.\r\n<ul class=\"listMCE\">\r\n<li>Comes highly recommended! Top quality and supreme print results with all print methods</li>\r\n<li>Consistent colours in all sizes for men, women and children </li>\r\n<li>Fair and sustainable</li>\r\n<li>Durable fabrics. 150g/m²</li>\r\n<li>Material: 100% cotton (charcoal: 50% cotton, 50% polyester, heather blue: 50% cotton, 50% polyester, heather grey: 85% cotton, 15% rayon)</li>\r\n</ul>",
   "categoryName":"T-Shirt",
   "brand":"Spreadshirt",
   "shippingFactor":1.0,
   "sizeFitHint":"normal fit",
   "manufacturingCountry":{
      "href":"https://api.spreadshirt.net/api/v1/shippingCountries/137",
      "id":"137"
   },
   "price":{
      "vatExcluded":10.92,
      "vatIncluded":12.99,
      "vat":19.00,
      "currency":{
         "href":"https://api.spreadshirt.net/api/v1/currencies/1",
         "id":"1"
      }
   },
   "defaultValues":{
      "defaultView":{
         "id":"1"
      },
      "defaultAppearance":{
         "id":"2"
      }
   },
   "appearances":[
      {
         "id":"411",
         "name":"washed burgundy",
         "colors":[
            {
               "index":0,
               "value":"#A95762"
            }
         ],
         "printTypes":[
            {
               "href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/2",
               "id":"2"
            },
            {
               "href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/14",
               "id":"14"
            },
         ],
         "resources":[
            {
               "mediaType":"png",
               "href":"https://image.spreadshirtmedia.net/image-server/v1/appearances/411"
            }
         ]
      },
      {
         "id":"566",
         "name":"heather burgundy",
         "colors":[
            {
               "index":0,
               "value":"#914857"
            }
         ],
         "printTypes":[
            {
               "href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/2",
               "id":"2"
            },
            {
               "href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/14",
               "id":"14"
            },
         ],
         "resources":[
            {
               "mediaType":"png",
               "href":"https://image.spreadshirtmedia.net/image-server/v1/appearances/566"
            }
         ]
      },
   ],
   "sizes":[
      {
         "id":"2",
         "name":"S",
         "group":"S",
         "weight":3.0,
         "measures":[
            {
               "name":"A",
               "value":{
                  "value":710,
                  "unit":"mm"
               }
            },
            {
               "name":"B",
               "value":{
                  "value":455,
                  "unit":"mm"
               }
            },
            {
               "name":"C",
               "value":{
                  "value":203,
                  "unit":"mm"
               }
            }
         ]
      },
      {
         "id":"3",
         "name":"M",
         "group":"M",
         "weight":4.0,
         "measures":[
            {
               "name":"A",
               "value":{
                  "value":735,
                  "unit":"mm"
               }
            },
            {
               "name":"B",
               "value":{
                  "value":510,
                  "unit":"mm"
               }
            },
            {
               "name":"C",
               "value":{
                  "value":210,
                  "unit":"mm"
               }
            }
         ]
      },
   ],
   "attributes":[

   ],
   "washingInstructions":[

   ],
   "views":[
      {
         "id":"1",
         "name":"Front",
         "perspective":"front",
         "resources":[
            {
               "mediaType":"png",
               "href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/views/1/appearances/2"
            }
         ],
         "state":"ACTIVATED"
      },
      {
         "id":"2",
         "name":"Back",
         "perspective":"back",
         "resources":[
            {
               "mediaType":"png",
               "href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/views/2/appearances/2"
            }
         ],
         "state":"ACTIVATED"
      },
   ],
   "printAreas":[ ],
   "stockStates":[
      {
         "appearance":{
            "id":"1"
         },
         "size":{
            "id":"102"
         },
         "available":true,
         "quantity":354
      },
      {
         "appearance":{
            "id":"1"
         },
         "size":{
            "id":"38"
         },
         "available":true,
         "quantity":466
      },
      {
         "appearance":{
            "id":"1"
         },
         "size":{
            "id":"94"
         },
         "available":true,
         "quantity":365
      },
   ],
   "resources":[
      {
         "mediaType":"png",
         "type":"preview",
         "href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/views/1/appearances/2"
      },
      {
         "mediaType":"png",
         "type":"size",
         "href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/variants/size"
      },
      {
         "mediaType":"png",
         "type":"detail",
         "href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/variants/detail"
      }
   ],
}