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": "a2ce02cd-bd2f-497a-8556-6fc5c6deac1d", "DiscountId": "b8b64f0f-fc7c-4f72-96b0-9588deb3f78b", "SelectedParentEntities": [ 1, 2 ], "Name": "sample string 3", "Period": { "DateRanges": [ { "StartDate": "2025-04-02T02:19:08.3619285+00:00", "EndDate": "2025-04-02T02:19:08.3619285+00:00" }, { "StartDate": "2025-04-02T02:19:08.3619285+00:00", "EndDate": "2025-04-02T02:19:08.3619285+00:00" } ], "Tag": "sample string 1" }, "Status": "sample string 4", "Condition": { "MatchAll": { "Products": { "Products": [ "513a05c0-d71f-4a85-9b1f-5aa4e3078545", "5903bc51-d1d3-4fad-87e4-266ca7a9ae2b" ], "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-04-02T02:19:08.3619285+00:00", "By": 2 }, "Activated": { "On": "2025-04-02T02:19:08.3619285+00:00", "By": 2 }, "Deactivated": { "On": "2025-04-02T02:19:08.3619285+00:00", "By": 2 } } }, { "Id": "a2ce02cd-bd2f-497a-8556-6fc5c6deac1d", "DiscountId": "b8b64f0f-fc7c-4f72-96b0-9588deb3f78b", "SelectedParentEntities": [ 1, 2 ], "Name": "sample string 3", "Period": { "DateRanges": [ { "StartDate": "2025-04-02T02:19:08.3619285+00:00", "EndDate": "2025-04-02T02:19:08.3619285+00:00" }, { "StartDate": "2025-04-02T02:19:08.3619285+00:00", "EndDate": "2025-04-02T02:19:08.3619285+00:00" } ], "Tag": "sample string 1" }, "Status": "sample string 4", "Condition": { "MatchAll": { "Products": { "Products": [ "513a05c0-d71f-4a85-9b1f-5aa4e3078545", "5903bc51-d1d3-4fad-87e4-266ca7a9ae2b" ], "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-04-02T02:19:08.3619285+00:00", "By": 2 }, "Activated": { "On": "2025-04-02T02:19:08.3619285+00:00", "By": 2 }, "Deactivated": { "On": "2025-04-02T02:19:08.3619285+00:00", "By": 2 } } } ]