# Retrieve a promotion

Only available to Buyer Users.

Endpoint: GET /me/promotions/{promotionID}
Version: 1.0.445.36017
Security: OAuth2

## Path parameters:

  - `promotionID` (string, required)
    ID of the promotion.

## Response 200 fields (application/json):

  - `ID` (string)

  - `LineItemLevel` (boolean)
    If true, certain eligible expression requirements must be met, and the PromotionDiscount will be applied at the line item level.

  - `Code` (string)
    Must be unique. Entered by buyer when adding promo to order.

  - `Name` (string)

  - `RedemptionLimit` (integer)
    Limit the total number of orders this promotion can be applied to across all users.

  - `RedemptionLimitPerUser` (integer)
    Limit the total number of orders this promotion can be applied to per user.

  - `RedemptionCount` (integer)
    The number of times this promotion has been applied to an order.

  - `QuantityLimitPerOrder` (integer)
    Can only be used when LineItemLevel is true and ItemLimitPerOrder does not have a value. When defined the ValueExpression will be the discount applied to each qualifying quantity of eligible items. When no ItemSortBy is defined, items will be sorted by DateAdded ascending.

  - `ItemLimitPerOrder` (integer)
    Can only be used when LineItemLevel is true and QuantityLimitPerOrder does not have a value. Limits the number of items the promotion will apply to when eligible. When no ItemSortBy is defined, items will be sorted by DateAdded ascending.

  - `ItemSortBy` (string)
    Comma delimited list of properties to sort by. Can only be used when ItemLimitPerOrder is true. Used to determine the order in which the promotion is applied to the specified limit of items. Use ! to reverse sort order on a property.

  - `Description` (string)

  - `FinePrint` (string)
    For reference only. Terms, conditions, and other legal jargon.

  - `StartDate` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `ExpirationDate` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `EligibleExpression` (string)
    The expression evaluated to determine if an item or order is eligible for a promotion. See rules engine documentation for formatting details.

  - `ValueExpression` (string)
    The expression evaluated to determine the discount amount of an eligible promotion. See rules engine documentation for formatting details.

  - `CanCombine` (boolean)
    If true, the promotion can be applied to an order that already other promotions applied, as long as they can also be combined.

  - `AllowAllBuyers` (boolean)
    Allow promo to be used by all buyers without creating explicit assignments.

  - `OwnerID` (string)
    ID of the organization that owns the promotion. Only the marketplace owner can override the OwnerID on create.

  - `AutoApply` (boolean)

  - `Active` (boolean)

  - `UseIntegration` (boolean)

  - `Priority` (integer)
    Used to control the order in which promotions are applied when calling the auto apply or refresh endpoint.

  - `xp` (object)
    Example: {}

## Response 4XX fields (application/json):

  - `StatusCode` (integer)
    Example: "404"

  - `ErrorCode` (string)
    Example: "NotFoundError"

  - `Message` (string)
    Example: "Object not found"

  - `Data` (object)
    Example: {"ObjectType":"","ObjectID":""}