# Get a promotion

Gets a promotion.

Endpoint: GET /ShoppingService.svc/rest/GetPromotion
Version: 1.1

## Query parameters:

  - `id` (integer)
    Internal id of promotion

  - `cultureCode` (string)
    Specifies in which language to display culture specific information. If none is supplied, value is resolved from Application.

## Response 200 fields (application/json):

  - `Id` (integer,null)
    The internal id of the Promotion.

  - `Name` (string)
    The Name of the Promotion. MaxLength: 255.

  - `Header` (string)
    SubHeader from Storm. MaxLength: 255.

  - `ShortDescription` (string)
    DescriptionHeader from Storm. MaxLength: 255.

  - `Description1` (string)
    Description from Storm. MaxLength: max.

  - `Description2` (string)
    SubDescription from Storm. MaxLength: max.

  - `StartDate` (string,null)
    The StartDate of the Promotion, if any. Only valid promotions will be returned.

  - `EndDate` (string,null)
    The EndDate of the Promotion, if any. Only valid promotions will be returned.

  - `ImageKey` (string,null)
    A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.

  - `RequirementSeed` (string)
    A comma separated list of fulfilled requirements for this promotion. MaxLength: max.

  - `DiscountCode` (string)
    Will contain the discountCode if the promotion has a discountCode requirement. MaxLength: max.

  - `IsExcludedFromPriceCalculation` (boolean)
    A value of true means the promotion was applied last an not included in any price calculations.

  - `AllowProductListing` (boolean)
    This flag can be checked to see whether the promotion allows listing of products from requirements. Use Products.ListProductsByPromotionRequirement to list products. Note that if this property is true and no product requirements exists, no products will be listed.

  - `Images` (array)
    A list of additional images files uploaded for the promotion. Images can be differentiated by using different types. See ListPromotionImageTypes for available types.

  - `Images.Id` (integer)
    The internal id of the File.

  - `Images.Type` (integer)
    The type id of the File. Depending on context and Client. Can be used by Applications to differentiate files for different usages.

  - `Images.Name` (string)
    The Name of the File. MaxLength: 50.

  - `Images.Description` (string)
    The Description of the File. MaxLength: max.

  - `Images.Key` (string,null)
    A unique id for the File at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.

  - `ProductFilters` (array)
    A list of productFilters for the promotion. Can be used to filter or fetch promotions matched by Products. match the products properties against the filter values Each ProductFilter must match all existing values and if any ProductFilter matches the promotion will be valid for that product.

  - `ProductFilters.ManufacturerId` (integer,null)
    An optional Manufacturer internal id for filtered products.

  - `ProductFilters.CategorySeed` (string)
    An optional CategorySeed for filtered products. MaxLength: int.

  - `ProductFilters.TypeId` (integer,null)
    An optional SKU Type internal id for filtered products.

  - `ProductFilters.ProductId` (integer,null)
    An optional Product internal id for filtered products.

  - `ProductFilters.VariantProductId` (integer,null)
    An optional VariantProduct internal id for filtered products. Equal to use PartNo.

  - `ProductFilters.PartNo` (string)
    An optional PartNo for filtered products. Equal to use VariantProductId. MaxLength: 50.

  - `ProductFilters.PricelistId` (integer,null)
    An optional pricelist internal id for filtered products.

  - `ProductFilters.FlagId` (integer,null)
    An optional Flag internal id for filtered products. Only set if flagId is inclusive.

  - `AppliedAmount` (number,null)
    Applied discount amount, excluding VAT, if fetched on AppliedPromotions property on the basket. In that case it will be the sum of all applied amounts on all Basket.Items. This value is rounded to two decimals.

  - `EffectSeed` (string)
    A comma separated list of applicable effects for this promotion. MaxLength: max.

  - `FreightDiscountPct` (number,null)
    FreightDiscountPct can be used to calculate external freight prices. The value is given as percentage as 100.00 for 100% discount. Only used for FreightDiscounts.

  - `IsStackable` (boolean)
    Promotion effect quantity or basket discount is multiplied with how many times requirement is fulfilled.

  - `AppliedAmountIncVat` (number,null)
    Applied discount amount, including VAT, for this Promotion on this BasketItem.

  - `ExclusivityType` (integer)
    ExclusivityType allows setting promotions as NotExclusive = 0, Exclusive = 1, or IgnoreExclusivity = 2.