Get catalog for a specific Choice product
Use the following endpoint to get the catalog for a specific choice product in your platform:
| Function | Purpose |
|---|---|
GET {URI}/choiceProducts/{choiceProductUtid}/catalog | Get catalog for a specific Choice product utid. |
The following path parameter is required for this endpoint. UTID is Unique Tango ID {{utid}} for the item being ordered such as Gift Cards or nonprofit donations (NPO).
| Path params | Data type | Description |
|---|---|---|
| choiceProductUtid | string | Utid is a unique Tango Card ID. (required) |
The following query parameters are used with this endpoint:
| Query params | Data type | Description |
|---|---|---|
| verbose | boolean | True or false. When true, will return the additional brand fields: status, disclaimer, description, shortDescription, terms, brandRequirements collection, and imageUrls collection. |
| brandKey | string | Returns the brand and item details for a specific brand ID. |
| brandName | string | Returns the brand and item details for a specific brand name. |
| utid | string | Returns the brand and item details for a specific utid. The utid is the unique identifier for a specific reward. |
| rewardName | string | Returns the brand and item details of the specified reward name. |
| status | string | Returns all brands and item details with the specified status. Possible statuses are: Test, Active, Inactive, Deleted. |
| currencyCode | string | Return all brands and item details associated with a specific currency. Note: We only accept CAD, EUR, GBP, or USD. Only one currency can be specified. Currency can never be changed. The currency defaults to USD if no currency is specified. |
| country | string | Returns all brands and item details from a specific country. |
| fulfillmentType | array of strings | Returns all brands and item details for a specific fulfillment type: -DIGITAL -PHYSICAL |
| categoryIds | array of strings | Returns all brands and item details for specific brand categories. (coming in Q1 of 2024) |
Note:
isExpirableindicates whether or not the gift card has an expiry date. The value forisExpirable =boolean\is true or false.- Expiration date only applies to Promo Links.
The following example shows the payload for a specific Choice Product UTID for when verbose=false.
{
"catalogName": "Global Choice Link Catalog",
"brands": [
{
"brandKey": "B570932",
"brandName": "1-800-FLOWERS.COM®",
"createdDate": "2016-04-26T17:27:19Z",
"lastUpdateDate": "2024-02-20T18:42:36Z",
"items": [
{
"utid": "U935268",
"rewardName": "1-800-FLOWERS.COM® Gift Card $10.00",
"currencyCode": "USD",
"status": "active",
"valueType": "FIXED_VALUE",
"rewardType": "gift card",
"isExpirable": false,
"isWholeAmountValueRequired": false,
"faceValue": 10,
"createdDate": "2016-07-19T18:41:23.217Z",
"lastUpdateDate": "2024-05-09T17:09:48.07Z",
"countries": [
"US"
],
"credentialTypes": [
"cardNumber",
"pin",
"rewardSecurityCode",
"rewardSecurityUrl"
],
"redemptionInstructions": "<p>Where you can redeem your Gift Card:</p>\n<ol>\n<li>Online at <a href=\"http://www.1800baskets.com\">www.1800baskets.com</a>, <a href=\"http://www.1800flowers.com\">www.1800flowers.com</a>, <a href=\"http://www.cheryls.com\">www.cheryls.com</a>, and <a href=\"http://www.thepopcornfactory.com\">www.thepopcornfactory.com</a>. By phone on orders for 1-800-BASKETS.COM, 1-800-FLOWERS.com®, Cheryl's®, and The Popcorn Factory.</li>\n<li>At our company owned and participating franchised retail store locations of Fannie May at certain, but not all, franchised retail store locations of 1-800-Flowers.com®, Conroy's, and Conroy's 1-800-Flowers®.</li>\n</ol>\n<p>Limit one Gift Card, Fresh Rewards pass and/or Savings Pass per order. Some promotions may restrict redemption to certain brands and will be clearly noted on the promotion. May become redeemable at additional brands and locations, which information will be updated on this page. See conditions and restrictions as detailed below. </p>",
"fulfillmentType": "DIGITAL"
},
{
"utid": "U683701",
"rewardName": "1-800-FLOWERS.COM® Gift Card $25.00",
"currencyCode": "USD",
"status": "active",
"valueType": "FIXED_VALUE",
"rewardType": "gift card",
"isExpirable": false,
"isWholeAmountValueRequired": false,
"faceValue": 25,
"createdDate": "2016-07-19T19:44:16.151Z",
"lastUpdateDate": "2024-05-09T17:13:24.97Z",
"countries": [
"US"
],
"credentialTypes": [
"cardNumber",
"pin",
"rewardSecurityCode",
"rewardSecurityUrl"
],
"redemptionInstructions": "<p>Where you can redeem your Gift Card:</p>\n<ol>\n<li>Online at <a href=\"http://www.1800baskets.com\">www.1800baskets.com</a>, <a href=\"http://www.1800flowers.com\">www.1800flowers.com</a>, <a href=\"http://www.cheryls.com\">www.cheryls.com</a>, and <a href=\"http://www.thepopcornfactory.com\">www.thepopcornfactory.com</a>. By phone on orders for 1-800-BASKETS.COM, 1-800-FLOWERS.com®, Cheryl's®, and The Popcorn Factory.</li>\n<li>At our company owned and participating franchised retail store locations of Fannie May at certain, but not all, franchised retail store locations of 1-800-Flowers.com®, Conroy's, and Conroy's 1-800-Flowers®.</li>\n</ol>\n<p>Limit one Gift Card, Fresh Rewards pass and/or Savings Pass per order. Some promotions may restrict redemption to certain brands and will be clearly noted on the promotion. May become redeemable at additional brands and locations, which information will be updated on this page. See conditions and restrictions as detailed below. </p>",
"fulfillmentType": "DIGITAL"
},
The following example shows the payload for a specific Choice Product UTID for when verbose=true
{
"catalogName": "Global Choice Link Catalog",
"brands": [
{
"brandKey": "B570932",
"brandName": "1-800-FLOWERS.COM®",
"disclaimer": "<p>*1-800-FLOWERS.COM is not a sponsor of the rewards or otherwise affiliated with this company. The logos and other identifying marks attached are trademarks of and owned by each represented company and/or its affiliates. Please visit each company's website for additional terms and conditions.</p>\r\n",
"description": "<p>Gift-giving has never been easier with the 1-800-FLOWERS.COM® Gift Card! Browse a wide selection of fresh flowers, delicious gourmet treats and desserts, beautiful plants, stunning gift baskets and more – and then choose exactly what you want!</p>\r\n",
"shortDescription": "<p>Gift-giving has never been easier with the 1-800-FLOWERS.COM® Gift Card! Browse a wide selection of fresh flowers, delicious gourmet treats and desserts, beautiful plants, stunning gift baskets and more – and then choose exactly what you want!</p>\r\n",
"terms": "<p>You can use your eGift Card at any Cheryls® or Harry & David® retail stores and online at <a href=\"https://www.1800baskets.com/\">www.1800baskets.com</a>, <a href=\"https://www.1800flowers.com/\">www.1800flowers.com</a>, <a href=\"https://www.cheryls.com/\">www.cheryls.com</a>, <a href=\"https://www.fruitbouquets.com/\">www.fruitbouquets.com</a>, <a href=\"https://www.harryanddavid.com/\">www.harryanddavid.com</a>, <a href=\"https://www.stockyards.com/\">www.stockyards.com</a>, <a href=\"https://www.thepopcornfactory.com/\">www.thepopcornfactory.com</a> and <a href=\"https://www.wolfermans.com/\">www.wolfermans.com</a>. Acceptance of this card constitutes acceptance of these terms and conditions, which may change at any time. To view your eGift Card balance, go to <a href=\"http://freshgift.com/\">http://freshgift.com/</a>. This eGift Card does not expire.</p>",
"createdDate": "2016-04-26T17:27:19Z",
"lastUpdateDate": "2024-02-20T18:42:36Z",
"brandRequirements": {
"displayInstructions": "<p> </p>\r\n\r\n<p> </p>\r\n\r\n<p> </p>\r\n",
"termsAndConditionsInstructions": "<p> </p>\r\n\r\n<p> </p>\r\n\r\n<p> </p>\r\n",
"disclaimerInstructions": "<p>Brand Disclaimer to be used when 1-800-FLOWERS.COM is the only brand presented on a page or in an email. Otherwise, if it’s one of two or more brands being shown, you may use the General Merchant Disclaimer. <br />\r\nPresent the Terms and Conditions anytime you’re presenting specific gift card use details.</p>\r\n",
"alwaysShowDisclaimer": false
},
"imageUrls": {
"80w-326ppi": "https://dwwvg90koz96l.cloudfront.net/images/brands/b276872-80w-326ppi.png",
"130w-326ppi": "https://dwwvg90koz96l.cloudfront.net/images/brands/b276872-130w-326ppi.png",
"200w-326ppi": "https://dwwvg90koz96l.cloudfront.net/images/brands/b276872-200w-326ppi.png",
"278w-326ppi": "https://dwwvg90koz96l.cloudfront.net/images/brands/b276872-278w-326ppi.png",
"300w-326ppi": "https://dwwvg90koz96l.cloudfront.net/images/brands/b276872-300w-326ppi.png",
"1200w-326ppi": "https://dwwvg90koz96l.cloudfront.net/images/brands/b276872-1200w-326ppi.png"
},
"status": "active",
"items": [
{
"utid": "U935268",
"rewardName": "1-800-FLOWERS.COM® Gift Card $10.00",
"currencyCode": "USD",
"status": "active",
"valueType": "FIXED_VALUE",
"rewardType": "gift card",
"isExpirable": false,
"isWholeAmountValueRequired": false,
"faceValue": 10,
"createdDate": "2016-07-19T18:41:23.217Z",
"lastUpdateDate": "2024-05-09T17:09:48.07Z",
"countries": [
"US"
],
"credentialTypes": [
"cardNumber",
"pin",
"rewardSecurityCode",
"rewardSecurityUrl"
],
"redemptionInstructions": "<p>Where you can redeem your Gift Card:</p>\n<ol>\n<li>Online at <a href=\"http://www.1800baskets.com\">www.1800baskets.com</a>, <a href=\"http://www.1800flowers.com\">www.1800flowers.com</a>, <a href=\"http://www.cheryls.com\">www.cheryls.com</a>, and <a href=\"http://www.thepopcornfactory.com\">www.thepopcornfactory.com</a>. By phone on orders for 1-800-BASKETS.COM, 1-800-FLOWERS.com®, Cheryl's®, and The Popcorn Factory.</li>\n<li>At our company owned and participating franchised retail store locations of Fannie May at certain, but not all, franchised retail store locations of 1-800-Flowers.com®, Conroy's, and Conroy's 1-800-Flowers®.</li>\n</ol>\n<p>Limit one Gift Card, Fresh Rewards pass and/or Savings Pass per order. Some promotions may restrict redemption to certain brands and will be clearly noted on the promotion. May become redeemable at additional brands and locations, which information will be updated on this page. See conditions and restrictions as detailed below. </p>",
"fulfillmentType": "DIGITAL"
},
{
"utid": "U683701",
"rewardName": "1-800-FLOWERS.COM® Gift Card $25.00",
"currencyCode": "USD",
"status": "active",
"valueType": "FIXED_VALUE",
"rewardType": "gift card",
"isExpirable": false,
"isWholeAmountValueRequired": false,
"faceValue": 25,
"createdDate": "2016-07-19T19:44:16.151Z",
"lastUpdateDate": "2024-05-09T17:13:24.97Z",
"countries": [
"US"
],
"credentialTypes": [
"cardNumber",
"pin",
"rewardSecurityCode",
"rewardSecurityUrl"
],
"redemptionInstructions": "<p>Where you can redeem your Gift Card:</p>\n<ol>\n<li>Online at <a href=\"http://www.1800baskets.com\">www.1800baskets.com</a>, <a href=\"http://www.1800flowers.com\">www.1800flowers.com</a>, <a href=\"http://www.cheryls.com\">www.cheryls.com</a>, and <a href=\"http://www.thepopcornfactory.com\">www.thepopcornfactory.com</a>. By phone on orders for 1-800-BASKETS.COM, 1-800-FLOWERS.com®, Cheryl's®, and The Popcorn Factory.</li>\n<li>At our company owned and participating franchised retail store locations of Fannie May at certain, but not all, franchised retail store locations of 1-800-Flowers.com®, Conroy's, and Conroy's 1-800-Flowers®.</li>\n</ol>\n<p>Limit one Gift Card, Fresh Rewards pass and/or Savings Pass per order. Some promotions may restrict redemption to certain brands and will be clearly noted on the promotion. May become redeemable at additional brands and locations, which information will be updated on this page. See conditions and restrictions as detailed below. </p>",
"fulfillmentType": "DIGITAL"
},
Here's an example payload for when you receive an error:
{
"timestamp": "2025-02-21T23:23:13.930Z",
"requestId": "string",
"path": "string",
"httpCode": 0,
"httpPhrase": "string",
"i18nKey": "string",
"message": "The error message will show here for error codes ",
"errors": [
{}
]
}
The possible response codes for this endpoint are:
- 200 OK
- 400 Bad request
- 401 Unauthorized
- 403 Forbidden
Updated about 1 month ago