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 PromotionsByLocationReturn

Name	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": "dc801fb2-0055-4c5a-a9c1-5c55e1a1564f",
    "DiscountId": "bdb04da0-a0e9-472b-aeff-0e37b16a705c",
    "SelectedParentEntities": [
      1,
      2
    ],
    "Name": "sample string 3",
    "Period": {
      "DateRanges": [
        {
          "StartDate": "2026-01-20T10:38:32.8364428+00:00",
          "EndDate": "2026-01-20T10:38:32.8364428+00:00"
        },
        {
          "StartDate": "2026-01-20T10:38:32.8364428+00:00",
          "EndDate": "2026-01-20T10:38:32.8364428+00:00"
        }
      ],
      "Tag": "sample string 1"
    },
    "Status": "sample string 4",
    "Condition": {
      "MatchAll": {
        "Products": {
          "Products": [
            "6cb86ac3-7da8-4ccd-a188-4d103f84b316",
            "32488561-ead2-4005-9f9d-74c12f05f92c"
          ],
          "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": "2026-01-20T10:38:32.8520665+00:00",
        "By": 2
      },
      "Activated": {
        "On": "2026-01-20T10:38:32.8520665+00:00",
        "By": 2
      },
      "Deactivated": {
        "On": "2026-01-20T10:38:32.8520665+00:00",
        "By": 2
      }
    }
  },
  {
    "Id": "dc801fb2-0055-4c5a-a9c1-5c55e1a1564f",
    "DiscountId": "bdb04da0-a0e9-472b-aeff-0e37b16a705c",
    "SelectedParentEntities": [
      1,
      2
    ],
    "Name": "sample string 3",
    "Period": {
      "DateRanges": [
        {
          "StartDate": "2026-01-20T10:38:32.8364428+00:00",
          "EndDate": "2026-01-20T10:38:32.8364428+00:00"
        },
        {
          "StartDate": "2026-01-20T10:38:32.8364428+00:00",
          "EndDate": "2026-01-20T10:38:32.8364428+00:00"
        }
      ],
      "Tag": "sample string 1"
    },
    "Status": "sample string 4",
    "Condition": {
      "MatchAll": {
        "Products": {
          "Products": [
            "6cb86ac3-7da8-4ccd-a188-4d103f84b316",
            "32488561-ead2-4005-9f9d-74c12f05f92c"
          ],
          "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": "2026-01-20T10:38:32.8520665+00:00",
        "By": 2
      },
      "Activated": {
        "On": "2026-01-20T10:38:32.8520665+00:00",
        "By": 2
      },
      "Deactivated": {
        "On": "2026-01-20T10:38:32.8520665+00:00",
        "By": 2
      }
    }
  }
]