GET v1/Companies/{companyId}/ConditionCapabilities/{condBits}/PromotionTypeCapabilities/{proBits}/Promotions
This call is used to fetch all existing promotions for a company constrained by the specified capabilities.
Information:
Base URL:
https://api.covasoft.net/promotions
Example of a call would be:
GET /Promotions/v1/Companies/{companyId}/ConditionCapabilities/{condBits}/PromotionTypeCapabilities/{proBits}/Promotions
Host: api.covasoft.net
Authorization: Bearer {your token}
Accept: application/json
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| companyId |
The CompanyId of the promotions being requested |
integer |
Required |
| condBits |
Bitmask of condition capabilities supported by the caller |
integer |
Required |
| proBits |
Bitmask of the promotion type capabilities supported by the caller |
integer |
Required |
Body Parameters
None.
Response Information
Resource Description
Collection of Promotion| Name | Description | Type | Additional information |
|---|---|---|---|
| PromotionId |
The unique Id for this promotion |
globally unique identifier |
None. |
| CompanyId |
The company Id this promotion belongs to |
integer |
None. |
| Name |
The name of the promotion |
string |
None. |
| Status |
The status of the Promotion. 'Active' or 'Deleted'. Results from this endpoint will always be 'Active' |
string |
None. |
| HumanReadablePromotionType |
A human readable string representing the type of promotion. Can be 'BOGO', 'Buy X Get Y', 'Bundle', 'Dollar Off', or 'Percent Off' Based on PromotionType. CheapestMatchedFor_ maps to 'BOGO'. MatchThenCheapestOtherFor_ maps to 'Buy X Get Y'. BundleFor_ maps to 'Bundle'. EachMatchedDollarOff maps to 'Dollar Off'. 'EachMatchedPercentOff' maps to 'Percent Off'. |
string |
None. |
| EnabledAtLocationIds |
A list of the Location identifiers where this promotion is applicable |
Collection of integer |
None. |
| ICalVEventSchedule |
An iCal formatted VEVENT string representing the period of time the promotion is active. See [iCal documentation](https://icalendar.org/) for more information. The PromotionId will always be included as the SUMMARY. |
string |
None. |
| PromotionType |
An object with details about the promotion. |
PromotionType |
None. |
| CartCondition |
A tree of conditions the cart must meet before this promotion can be applied. |
CartCondition |
None. |
| LineCondition |
A tree of conditions a line must meet before it can be considered for this promotion. |
LineCondition |
None. |
| CreatedByUserId |
The userId that created this promotion. |
integer |
None. |
| CreatedDateTimeUtc |
The DateTime this promotion was created. |
date |
None. |
| Version |
The current version of this promotion. Increments by 1 for each change made to this promotion. |
integer |
None. |
Response Formats
application/json
Sample not available.
text/json
Sample not available.