# Models

## The Deal object

```json
{"openapi":"3.1.0","info":{"title":"Brand Deals API","version":"v11"},"components":{"schemas":{"Deal":{"type":"object","properties":{"Id":{"type":"string","description":"The unique identifier for the deal."},"Name":{"type":"string","description":"The display name of the deal."},"CampaignId":{"type":"string","description":"The unique identifier of the campaign the deal belongs to."},"State":{"type":"string","description":"The current state of the deal.","enum":["ACTIVE","EXPIRED","PENDING"]},"Type":{"type":"string","description":"The type of deal — what it offers.","enum":["GENERAL_SALE","FREE_SHIPPING","GIFT_WITH_PURCHASE","REBATE","BOGO"]},"Scope":{"type":"string","description":"What the deal applies to (a category, the entire store, or a specific product).","enum":["CATEGORY","ENTIRE_STORE","PRODUCT"]},"Description":{"type":"string","description":"A description of the deal that may be shown to partners."},"StartDate":{"type":"string","format":"date-time","description":"The date and time the deal becomes active."},"EndDate":{"type":"string","format":"date-time","description":"The date and time the deal expires."},"Categories":{"type":"string","description":"Comma-separated list of categories the deal applies to, when `Scope` is `CATEGORY`."},"BogoBuyQuantity":{"type":"integer","description":"Quantity the customer must buy in a BOGO deal."},"BogoBuyScope":{"type":"string","description":"Whether the \"buy\" requirement is a specific product or category in a BOGO deal."},"BogoBuyName":{"type":"string","description":"Name of the item the customer must buy in a BOGO deal."},"BogoBuyImageUrl":{"type":"string","format":"uri","description":"If `Type` is `BOGO`, the \"buy\" product image URL."},"BogoGetQuantity":{"type":"integer","description":"Quantity the customer receives in a BOGO deal."},"BogoGetScope":{"type":"string","description":"Whether the \"get\" item is a specific product or category in a BOGO deal."},"BogoGetDiscountType":{"type":"string","description":"How the discount on the \"get\" item is calculated in a BOGO deal."},"BogoGetName":{"type":"string","description":"Name of the item the customer receives in a BOGO deal."},"BogoGetImageUrl":{"type":"string","format":"uri","description":"If `Type` is `BOGO`, the \"get\" product image URL."},"BogoGetDiscountAmount":{"type":"number","format":"decimal","description":"Flat discount amount on the \"get\" item in a BOGO deal."},"BogoGetDiscountCurrency":{"type":"string","description":"Currency code for the BOGO get discount amount (ISO 4217)."},"BogoGetDiscountPercent":{"type":"number","format":"float","description":"Discount percentage on the \"get\" item in a BOGO deal."},"PurchaseLimitQuantity":{"type":"integer","description":"Maximum number of times the deal can be applied per order."},"DateCreated":{"type":"string","format":"date-time","description":"Date the deal was created."},"DateLastUpdated":{"type":"string","format":"date-time","description":"Date the deal was last updated."},"DiscountType":{"type":"string","description":"How the discount is calculated.","enum":["FIXED","PERCENT","PERCENT_RANGE","PERCENT_MAXIMUM"]},"DiscountAmount":{"type":"string","description":"The flat discount amount, when DiscountType is FIXED."},"DiscountMaximumPercent":{"type":"number","format":"float","description":"Maximum discount percentage, when `DiscountType` is `PERCENT_MAXIMUM`."},"DiscountPercentRangeStart":{"type":"number","format":"float","description":"Lower bound of the discount range, when `DiscountType` is `PERCENT_RANGE`."},"DiscountPercentRangeEnd":{"type":"number","format":"float","description":"Upper bound of the discount range, when `DiscountType` is `PERCENT_RANGE`."},"DiscountCurrency":{"type":"string","description":"Three-letter ISO 4217 currency code for the discount amount."},"MinimumPurchaseAmount":{"type":"number","format":"decimal","description":"Minimum amount the consumer needs to spend for the deal to apply."},"MinimumPurchaseAmountCurrency":{"type":"string","description":"Currency of the deal's minimum purchase amount (ISO 4217)."},"MaximumSavingsAmount":{"type":"number","format":"decimal","description":"Maximum amount a consumer can save when the deal applies."},"MaximumSavingsCurrency":{"type":"string","description":"Currency of the deal's maximum savings (ISO 4217)."},"DiscountPercent":{"type":"string","description":"The discount percentage, when DiscountType is PERCENT."},"Gift":{"type":"string","description":"Gift offered, when `Type` is `GIFT_WITH_PURCHASE`."},"RebateAmount":{"type":"number","format":"decimal","description":"Rebate amount, when `Type` is `REBATE`."},"RebateCurrency":{"type":"string","description":"Currency of the rebate amount (ISO 4217)."},"DefaultPromoCode":{"type":"string","description":"Default promo code partners can promote for this deal."},"Products":{"type":"array","description":"The products this deal applies to, when Scope is PRODUCT.","items":{"type":"object","properties":{"ProductName":{"type":"string","description":"The name of the product."},"ProductImageURL":{"type":"string","description":"URL of the product image."},"ProductBeforePriceAmount":{"type":"string","description":"The product's price before the deal is applied."},"ProductAfterPriceAmount":{"type":"string","description":"The product's price after the deal is applied."}}}},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to this deal in the impact.com API."}}}}}}
```

## The DealStatusResponse object

```json
{"openapi":"3.1.0","info":{"title":"Brand Deals API","version":"v11"},"components":{"schemas":{"DealStatusResponse":{"type":"object","properties":{"Status":{"type":"string","description":"Indicates whether the operation was successful."},"Uri":{"type":"string","description":"The unique reference to the affected deal."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/brand-api-reference/brand-api-reference-v11/reference/deals/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.