Get products

Order API v1
GET*base*/products
Authentication:API key

This will return product data from Centra with categories.

Parameters

sku

string
optional
 Get products with a specific SKU.

modified

date/datetime
optional
 Get all products modified after a certain date. Allowed formats YYYY-mm-dd and YYYY-mm-dd HH:MM:SS. Timezone is system-wide and decided by the company using Centra.

created

date/datetime
optional
 Get all products added after a certain date. Allowed formats YYYY-mm-dd and YYYY-mm-dd HH:MM:SS. Timezone is system-wide and decided by the company using Centra.

ean

string
optional
 Get a product with specified EAN code.

productId, variantId, stockItemID

integer
optional
 Filter products based on product, variant and stock item IDs.

limit

int
optional
 You will get this amount of products, and a “next” parameter in return if there are multiple pages. This will go a lot faster to fetch, instead of fetching all products at once.

include

string
optional
 include=attributes will also make the products include the custom attributes defined for each product and variant.

xml

boolean
optional
 Response in xml format instead of json.

Request example

1
2
GET <base>/products HTTP/1.1
Content-type: application/json

Response

200 Content-type: application/json

status

string
required
 ok if success, else no.

products

array

List of the products.

sku

string
 SKU for this product.

product

string
 The internal name for this product.

productId

integer
 ID for this product.

name

string
 The externally facing name for this product.

variantSku

string
 SKU for this variant.

variantId

integer
 ID for this variant.

sizeSku

string
 SKU for this size.

stockItemId

integer
 ID for this specific stock item.

ean

string
 The EAN for this product item size.

weight

decimal2 (0.00)
 The weight specified for this product.

weightUnit

string

The unit used for the weight.

  • kg
  • lb

size

string
 Name of the size for this specific product item.

active

boolean
 If the product item is active or not.

folder

string

String with names of the folders the product belongs to.

Like this: Collection / Jackets.

countryOfOrigin

string
 ISO-Alpha-2 (SE, US, GB etc)

categories

array of string

Array with names of the categories the product belongs to.

Like this: ["Collection / Jackets\/Outerwear", "..."].

images

array of string

URLs with the images connected to this product item.

Like this: ["https://xxx.centracdn.net/x/y/z.jpg", "https://..."].

prices

array

Array of the pricelists for this product.

id

int
 ID of the pricelist.

pricelist

string
 Name of the pricelist.

price

string
 Price for the product in this pricelist.

currency

string
 ISO code of the currency for this pricelist.

campaigns

array

List of campaigns this product is connected to in this pricelist.

id

int
 ID of the campaign.

campaign

string
 Name of the campaign.

price

decimal2 (0.00)
 The price when this campaign is applied to the price. Currency will always be the same as in the pricelist.

previous

string
optional
 Will contain a URL to the previous page.

next

string
optional
 Will contain a URL to the next page.

Response example

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
{
  "status": "ok",
  "products": [
    {
      "sku": "M411-740",
      "productId": 232,
      "variantSku": "",
      "variantId": 1211,
      "sizeSku": "",
      "brand": "Odd Molly",
      "collection": "Molly Prefall 2011",
      "product": "bakers cross 3\/4 blouse",
      "variant": "LITE ROSE",
      "size": "3",
      "stockItemId": 3424,
      "ean": "",
      "weight": 0.17,
      "weightUnit": "kg",
      "countryOfOrigin": "PT",
      "harmCode": "6206300090",
      "harmDescription": "Cotton - blouse",
      "active": 0,
      "folder": "Folder 1 / Folder 2"
      "name": "Bakers Cross",
      "description": "",
      "shortDescription": "",
      "comment": "",
      "categories": [
        "Collection \/ Jackets\/Outerwear",
        "New Arrivals"
      ],
      "images": [
        "https:\/\/...\/images\/1_0d2f67cd05.jpg",
        "https:\/\/...\/images\/1_318da2ad06.jpg",
        "https:\/\/...\/images\/1_c4e1c20d34.jpg"
      ],
      "prices": [
        {
          "id": "36",
          "price": "329.00",
          "pricelist": "EUR Europe",
          "currency": "EUR",
          "campaigns": [
            {
              "id": "40",
              "campaign": "OUTLET 50% NY",
              "price": 164.5
            }
          ]
        },
        {
          "id": "35",
          "price": "269.00",
          "pricelist": "GBP",
          "currency": "GBP",
          "campaigns": [
            {
              "id": "40",
              "campaign": "OUTLET 50% NY",
              "price": 134.5
            }
          ]
        }
      ]
    },
    {
      "sku": "M411-740",
      "productId": 232,
      "variantSku": "",
      "variantId": 1211,
      "sizeSku": "",
      "brand": "Odd Molly",
      "collection": "Molly Prefall 2011",
      "product": "bakers cross 3\/4 blouse",
      "variant": "LITE ROSE",
      "size": "4",
      "stockItemId": 3425,
      "ean": "",
      "weight": 0.17,
      "weightUnit": "kg",
      "countryOfOrigin": "PT",
      "harmCode": "6206300090",
      "harmDescription": "Cotton - blouse",
      "active": 0,
      "name": "Bakers Cross",
      "description": "",
      "shortDescription": "",
      "comment": "",
      "categories": [
        "Collection \/ Jackets\/Outerwear",
        "New Arrivals"
      ],
      "images": [
        "https:\/\/...\/images\/1_0d2f67cd05.jpg",
        "https:\/\/...\/images\/1_318da2ad06.jpg",
        "https:\/\/...\/images\/1_c4e1c20d34.jpg"
      ]
      "prices": [
        {
          "id": "36",
          "price": "329.00",
          "pricelist": "EUR Europe",
          "currency": "EUR",
          "campaigns": [
            {
              "id": "40",
              "campaign": "OUTLET 50% NY",
              "price": 164.5
            }
          ]
        },
        {
          "id": "35",
          "price": "269.00",
          "pricelist": "GBP",
          "currency": "GBP",
          "campaigns": [
            {
              "id": "40",
              "campaign": "OUTLET 50% NY",
              "price": 134.5
            }
          ]
        }
      ]
    }
  ],
  "previous": "?limit=10&page=2",
  "next": "?limit=10&page=3"
}