In our terminology, a design represents a pixel (png, jpg, gif) or vector image (svg) that you uploaded in the Partner Area.

List of all designs in the shop

MethodURLExample
GET/api/v1/shops/<shopId>/designshttps://api.spreadshirt.net/api/v1/shops/100488332/designs?mediaType=json


Query ParameteDescription
limitBetween 1 and 1000. Determines the maximum number of results per request.
offsetAllows pagination.



{
   "offset":0,
   "limit":10,
   "count":2,
   "designs":[
      {
         "id":"163261757",
         "href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757",
         "name":"I love you",
         "backgroundColor":"#666666",
         "resources":[
            {
               "href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757",
               "mediaType":"png",
               "type":"preview"
            }
         ],
      },
      {
         "id":"163261722",
         "href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261722",
         "name":"pinguine",
         "resources":[
            {
               "href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261722",
               "mediaType":"png",
               "type":"preview"
            }
         ],
      },
   ]
}


Details about a design

MethodURLExample
GET/api/v1/shops/<shopId>/designs/<designId>

https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757?mediaType=json


A design has the following characteristics:


{
   "href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757",
   "id":"163261757",
   "created":"2019-07-08T08:03:56.000+0000",
   "modified":"2019-07-22T10:17:39.000+0000",
   "name":"I love you",
   "description":"A lovely design for you",
   "tags":"Love,Love hurts,Love me,Love parade,Love with heart,Loved,Lovestruck,You,Young money,Young wild and free,Your,Youtube,migration,shop api,test",
   "user":{
      "href":"https://api.spreadshirt.net/api/v1/users/117878306",
      "id":"117878306"
   },
   "size":{
      "width":3938.0,
      "height":1149.0,
      "unit":"px"
   },
   "colors":[

   ],
   "backgroundColor":"#666666",
   "printTypes":[
      {
         "href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/17",
         "id":"17"
      },
      {
         "href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/1",
         "id":"1"
      },
   ],
   "resources":[
      {
         "mediaType":"png",
         "type":"preview",
         "href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757,backgroundColor=666666"
      },
      {
         "mediaType":"png",
         "type":"montage",
         "href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757"
      }
   ],
}