Get all available Choice products

Use the the following endpoint to get all available Choice Products in your Tango platform's catalog:

FunctionPurpose
GET {URI}/choiceProductsGet all available Choice products.

To filter the results, use the following query parameters with this endpoint:

Query paramsData typeDescription
rewardNamestringSpecify the reward name to be queried.
currencyCodestringSpecify the currency code to be queried.
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.
countriesarray of stringsSpecify the list of countries to be queried.

The following example is the generic payload with this endpoint:

{
  "choiceProducts": [
    {
      "utid": "string",
      "rewardName": "string",
      "currencyCode": "string",
      "countries": [
        "string"
      ]
    }
  ]
}

The following payload is an example of available Tango Choice products in a platform's catalog:

{
  "choiceProducts": [
    {
      "utid": "U346020",
      "rewardName": "Disbursement Link",
      "currencyCode": "USD",
      "status": "active",
      "countries": [
        "US"
      ],
   },
    {
      "utid": "U088323",
      "rewardName": "Promo Link",
      "currencyCode": "USD",
      "status": "active",
      "countries": [
        "US"
      ]
    },
    {
          "utid": "U561593",
          "rewardName": "Reward Link Preferred + Donations",
          "currencyCode": "USD",
          "status": "active",
          "countries": [
            "US"
          ]
    }
]
}

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

© 2025 Tango API are provided by Tango, a division of BHN, Inc.