v10 - Promotions - Demo Endpoints

Get a list of products

Gets a paginated list of all products that are present within a promotion with promotionId 544860.

GET /retailer-demo/promotions/544860/products

  • Request

  • Response

Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "products" : [ {
    "ean" : "4005808940127",
    "relevanceScores" : [ {
      "countryCode" : "NL",
      "relevanceScore" : 13
    }, {
      "countryCode" : "BE",
      "relevanceScore" : 12
    } ],
    "maximumPrice" : 13.76
  } ]
}

Get list of promotions with multiple entries

Get list of promotions based on promotion type awareness.

GET /retailer-demo/promotions?promotion-type=PRICE_OFF&promotion-type=AWARENESS&page=1

  • Request

  • Response

Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "promotions" : [ {
    "promotionId" : "544289",
    "title" : "FuturePromoTest",
    "startDateTime" : "2021-04-24T00:00:00+02:00",
    "endDateTime" : "2021-05-20T00:00:00+02:00",
    "countries" : [ {
      "countryCode" : "NL"
    }, {
      "countryCode" : "BE"
    } ],
    "promotionType" : "AWARENESS",
    "retailerSpecificPromotion" : false,
    "campaign" : {
      "name" : "Deals",
      "startDateTime" : "2013-07-01T00:00:00+02:00"
    }
  }, {
    "promotionId" : "544242",
    "title" : "Korting op TEST",
    "startDateTime" : "2021-04-23T00:00:00+02:00",
    "endDateTime" : "2021-05-07T00:00:00+02:00",
    "countries" : [ {
      "countryCode" : "NL"
    }, {
      "countryCode" : "BE"
    } ],
    "promotionType" : "PRICE_OFF",
    "retailerSpecificPromotion" : false,
    "campaign" : {
      "name" : "CampaignForSDDTest",
      "startDateTime" : "2020-08-21T00:00:00+02:00"
    }
  } ]
}

Get list of promotions with a single entry

Get list of promotions based on promotion type price off.

GET /retailer-demo/promotions?promotion-type=PRICE_OFF&page=1

  • Request

  • Response

Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "promotions" : [ {
    "promotionId" : "533736",
    "title" : "Promotion title",
    "startDateTime" : "2020-09-10T00:00:00+02:00",
    "endDateTime" : "2021-09-01T00:00:00+02:00",
    "countries" : [ {
      "countryCode" : "NL"
    }, {
      "countryCode" : "BE"
    } ],
    "promotionType" : "PRICE_OFF",
    "retailerSpecificPromotion" : false,
    "campaign" : {
      "name" : "Deals",
      "startDateTime" : "2013-07-01T00:00:00+02:00"
    }
  } ]
}

Get promotion by promotion id

Get promotion by promotion id 533735 with promotion type price off.

GET /retailer-demo/promotions/533736

  • Request

  • Response

Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "promotionId" : "533736",
  "title" : "Test Promotion",
  "startDateTime" : "2021-09-10T00:00:00+02:00",
  "endDateTime" : "2022-01-01T00:00:00+01:00",
  "countries" : [ {
    "countryCode" : "NL"
  }, {
    "countryCode" : "BE"
  } ],
  "promotionType" : "PRICE_OFF",
  "retailerSpecificPromotion" : false,
  "campaign" : {
    "name" : "Deals",
    "startDateTime" : "2021-07-01T00:00:00+02:00",
    "endDateTime" : "2022-02-01T00:00:00+01:00"
  }
}