GET v2/Companies/{CompanyId}/Entities/{LocationId}/Promotions?EntityId={EntityId}
Returns promotions at and under a specific node in the company tree.
Information:
Base URL:
https://api.covasoft.net/pospromotions
Returns all promotions for a company at and under the EntityId node. For example, calling the endpoint with companyId = entityId will return all promotions defined in the company.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
CompanyId |
The unique Company Id that was provided in your on-boarding package. |
integer |
Required |
EntityId |
The entityId of the subtree to retrieve promotions on and under. |
integer |
Required |
LocationId | string |
None. |
Body Parameters
None.
Response Information
Resource Description
Collection of PromotionsByLocationReturnName | Description | Type | Additional information |
---|---|---|---|
Id | globally unique identifier |
None. |
|
DiscountId | globally unique identifier |
None. |
|
SelectedParentEntities | Collection of integer |
None. |
|
Name | string |
None. |
|
Period | PromotionsByLocationReturnPeriod |
None. |
|
Status | string |
None. |
|
Condition | PromotionsByLocationReturnCondition |
None. |
|
Rule | PromotionsByLocationReturnRule |
None. |
|
Audit | PromotionsByLocationReturnAudit |
None. |
Response Formats
application/json, text/json
Sample:
[ { "Id": "4baef62a-4394-4cdd-82d7-0afc11739d6a", "DiscountId": "6b9c3ef8-393a-42ae-9eda-9903b028971d", "SelectedParentEntities": [ 1, 2 ], "Name": "sample string 3", "Period": { "DateRanges": [ { "StartDate": "2025-10-10T18:50:02.9911083+00:00", "EndDate": "2025-10-10T18:50:02.9911083+00:00" }, { "StartDate": "2025-10-10T18:50:02.9911083+00:00", "EndDate": "2025-10-10T18:50:02.9911083+00:00" } ], "Tag": "sample string 1" }, "Status": "sample string 4", "Condition": { "MatchAll": { "Products": { "Products": [ "dc9f2bcc-0c76-4728-9adf-998f3975931c", "4ed71ebd-af45-4db5-ba4f-dd214bf6ec18" ], "Classifications": [ 1, 2 ], "Categories": [ 1, 2 ], "Tag": "sample string 1" } } }, "Rule": { "Tag": "sample string 1", "Discount": { "Dollar": 1.0, "Tag": "sample string 2" } }, "Audit": { "Created": { "On": "2025-10-10T18:50:02.9911083+00:00", "By": 2 }, "Activated": { "On": "2025-10-10T18:50:02.9911083+00:00", "By": 2 }, "Deactivated": { "On": "2025-10-10T18:50:02.9911083+00:00", "By": 2 } } }, { "Id": "4baef62a-4394-4cdd-82d7-0afc11739d6a", "DiscountId": "6b9c3ef8-393a-42ae-9eda-9903b028971d", "SelectedParentEntities": [ 1, 2 ], "Name": "sample string 3", "Period": { "DateRanges": [ { "StartDate": "2025-10-10T18:50:02.9911083+00:00", "EndDate": "2025-10-10T18:50:02.9911083+00:00" }, { "StartDate": "2025-10-10T18:50:02.9911083+00:00", "EndDate": "2025-10-10T18:50:02.9911083+00:00" } ], "Tag": "sample string 1" }, "Status": "sample string 4", "Condition": { "MatchAll": { "Products": { "Products": [ "dc9f2bcc-0c76-4728-9adf-998f3975931c", "4ed71ebd-af45-4db5-ba4f-dd214bf6ec18" ], "Classifications": [ 1, 2 ], "Categories": [ 1, 2 ], "Tag": "sample string 1" } } }, "Rule": { "Tag": "sample string 1", "Discount": { "Dollar": 1.0, "Tag": "sample string 2" } }, "Audit": { "Created": { "On": "2025-10-10T18:50:02.9911083+00:00", "By": 2 }, "Activated": { "On": "2025-10-10T18:50:02.9911083+00:00", "By": 2 }, "Deactivated": { "On": "2025-10-10T18:50:02.9911083+00:00", "By": 2 } } } ]