Retrieve loyalty promotion
GET
/v2/loyalty/programs/{program_id}/promotions/{promotion_id}
Retrieves a loyalty promotion.
Name | Description |
---|---|
promotion_
Required
|
The ID of the loyalty promotion to retrieve. |
program_
Required
|
The ID of the base loyalty program. To get the program ID,
call RetrieveLoyaltyProgram using the |
Response Fields
Name | Description |
---|---|
errors
|
Any errors that occurred during the request. |
loyalty_
|
The retrieved loyalty promotion. |
Examples
GET
/v2/loyalty/programs/{program_id}/promotions/{promotion_id}
cURL
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/loyalty/programs/d619f755-2d17-41f3-990d-c04ecedd64dd/promotions/loypromo_f0f9b849-725e-378d-b810-511237e07b67 \
-H 'Square-Version: 2023-01-19' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json'
Response JSON
{
"loyalty_promotion": {
"id": "loypromo_f0f9b849-725e-378d-b810-511237e07b67",
"name": "Tuesday Happy Hour Promo",
"incentive": {
"type": "POINTS_MULTIPLIER",
"points_multiplier_data": {
"points_multiplier": 3
}
},
"available_time": {
"start_date": "2022-08-16",
"time_periods": [
"BEGIN:VEVENT\nDTSTART:20220816T160000\nDURATION:PT2H\nRRULE:FREQ=WEEKLY;BYDAY=TU\nEND:VEVENT"
]
},
"trigger_limit": {
"times": 1,
"interval": "DAY"
},
"minimum_spend_amount_money": {
"amount": 2000,
"currency": "USD"
},
"qualifying_item_variation_ids": [
"CJ3RYL56ITAKMD4VRCM7XERS",
"AT3RYLR3TUA9C34VRCB7X5RR"
],
"status": "ACTIVE",
"created_at": "2022-08-16T08:38:54Z",
"updated_at": "2022-08-16T08:38:54Z",
"loyalty_program_id": "d619f755-2d17-41f3-990d-c04ecedd64dd"
}
}