Skip to main content

Gets a campaign by ID.

Gets a campaign by ID.

Path Parameters
id uuid — REQUIRED

The campaign ID.

Responses
200

The requested campaign.

Schema — OPTIONAL
Resource object — OPTIONAL
CampaignNumber int32 — OPTIONAL
Status string — OPTIONAL
RoundingMethod string — OPTIONAL
ContractVersion string — OPTIONAL
CampaignId uuid — OPTIONAL

Campaign ID.

CampaignBaseType int32 — OPTIONAL

Possible values: [0, 1, 2, 3]

Campaign base type. Allowed values are code, cart, and product.
0 = NOT_SET
1 = cart
2 = code
3 = product

Title object[] — OPTIONAL

Localized titles.

Language string — OPTIONAL

The language of the localized item.

Value string — OPTIONAL

The value of the localized item.

Description string — OPTIONAL

Description.

MarketId string — OPTIONAL

Market ID.

CampaignTypeId int32 — OPTIONAL

Campaign type ID. Fetch available campaign types from the campaign/types endpoint.

BuyQuantity int32 — OPTIONAL

Buy quantity.

Amounts object — OPTIONAL

Amounts. Key is ISO Currency code. Used by campaign types with an amount discount.

PayForQuantity int32 — OPTIONAL

Pay for quantity.

Priority int32 — OPTIONAL

Priority.

StopCombining boolean — OPTIONAL

Indicates whether to stop combining.

ValidFrom date-time — OPTIONAL

Valid from date.

ValidTo date-time — OPTIONAL

Valid to date.

PromoCode string — OPTIONAL

Promo code.

HideTitle boolean — OPTIONAL

Indicates whether to hide the title.

CantCombineWithCartCampaign boolean — OPTIONAL

Indicates whether the campaign cannot be combined with cart campaigns.

PercentageValue double — OPTIONAL

Percentage value.

ExcludeProductsOnSale boolean — OPTIONAL

Indicates whether to exclude products on sale.

SaleTypesToEnforce int32 — OPTIONAL

Possible values: [0, 1, 2, 3]

Sale types to enforce. Possible values are campaign, sale, and all.
0 = NOT_SET
1 = campaign
2 = sale
3 = all

MinimumPurchaseAmounts object — OPTIONAL

Minimum purchase amounts.

MinimumQuantity int32 — OPTIONAL

Minimum quantity.

CheckMinAmountAfterDiscounts boolean — OPTIONAL

Indicates whether to check minimum amount after discounts.

Scoped boolean — OPTIONAL

Toggles whether the campaign minimum requirements are scoped to the selected products only.

OncePerCustomer boolean — OPTIONAL

Indicates whether the campaign is limited to once per customer.

UseSalePrice boolean — OPTIONAL

Indicates whether to use the sale price when calculating campaign price.

FreeShipping boolean — OPTIONAL

Indicates whether free shipping is included.

UsageLimit int32 — OPTIONAL

Usage limit.

Prices object — OPTIONAL

Prices. Can be used with percentage campaign type.

LandingPage object — OPTIONAL

Represents a campaign landing page.

Title object[] — OPTIONAL

Localized titles for the landing page.

Language string — OPTIONAL

The language of the localized item.

Value string — OPTIONAL

The value of the localized item.

Url object[] — OPTIONAL

Localized URLs for the landing page. These can not be set directly, but are generated from the title.

Values string[] — OPTIONAL

Additional values for the extended localized item.

Language string — OPTIONAL

The language of the localized item.

Value string — OPTIONAL

The value of the localized item.

Description object[] — OPTIONAL

Localized descriptions for the landing page.

Language string — OPTIONAL

The language of the localized item.

Value string — OPTIONAL

The value of the localized item.

Meta object — OPTIONAL

Represents the meta information for a campaign landing page.

Title object[] — OPTIONAL

Localized titles for the meta information.

Language string — OPTIONAL

The language of the localized item.

Value string — OPTIONAL

The value of the localized item.

Keywords object[] — OPTIONAL

Localized keywords for the meta information.

Language string — OPTIONAL

The language of the localized item.

Value string — OPTIONAL

The value of the localized item.

Description object[] — OPTIONAL

Localized descriptions for the meta information.

Language string — OPTIONAL

The language of the localized item.

Value string — OPTIONAL

The value of the localized item.

SelectedUsers string[] — OPTIONAL

Selected users, usually an array of email addresses.

SelectedGroups string[] — OPTIONAL

Selected groups, usually an array of customer group IDs.

Enabled boolean — OPTIONAL

Indicates whether the campaign is enabled.

ProductSelection object — OPTIONAL

Represents the product selection criteria.

Include object — OPTIONAL

Represents the data for product selection criteria.

Condition int32 — OPTIONAL

Possible values: [0, 1]

Condition for combining criteria.
0 = and. Logical AND condition.
1 = or. Logical OR condition.

Categories object[] — OPTIONAL

List of category selections.

Id int32 — OPTIONAL

Item ID.

Name string — OPTIONAL

Item name.

Brands object[] — OPTIONAL

List of brand selections.

Id int32 — OPTIONAL

Item ID.

Name string — OPTIONAL

Item name.

Products int32[] — OPTIONAL

List of product IDs.

Price object[] — OPTIONAL

List of price selections.

Condition int32 — OPTIONAL

Possible values: [0, 1, 2]

Condition for the price selection.
0 = lt. Less than condition.
1 = gt. Greater than condition.
2 = eq. Equal to condition.

Prices object — OPTIONAL

Dictionary of prices. Currency ISO code is used for the key.

Exclude object — OPTIONAL

Represents the data for product selection criteria.

Condition int32 — OPTIONAL

Possible values: [0, 1]

Condition for combining criteria.
0 = and. Logical AND condition.
1 = or. Logical OR condition.

Categories object[] — OPTIONAL

List of category selections.

Id int32 — OPTIONAL

Item ID.

Name string — OPTIONAL

Item name.

Brands object[] — OPTIONAL

List of brand selections.

Id int32 — OPTIONAL

Item ID.

Name string — OPTIONAL

Item name.

Products int32[] — OPTIONAL

List of product IDs.

Price object[] — OPTIONAL

List of price selections.

Condition int32 — OPTIONAL

Possible values: [0, 1, 2]

Condition for the price selection.
0 = lt. Less than condition.
1 = gt. Greater than condition.
2 = eq. Equal to condition.

Prices object — OPTIONAL

Dictionary of prices. Currency ISO code is used for the key.

Group string — OPTIONAL

Group. Use it to group similar campaigns.

PriceOutput int32 — OPTIONAL

Possible values: [0, 1]

Price output type.
0 = Campaign
1 = Sale

Message string — OPTIONAL

A status message for the action taken.

Details string[] — OPTIONAL

Any validation messages for the data on the current action.

400

Bad request.

Schema — OPTIONAL
Message string — OPTIONAL

A status message for the action taken.

Details string[] — OPTIONAL

Any validation messages for the data on the current action.

404

Not found.

Schema — OPTIONAL
Message string — OPTIONAL

A status message for the action taken.

Details string[] — OPTIONAL

Any validation messages for the data on the current action.