Get all available Choice products
Use the the following endpoint to get all available Choice Products in your Tango platform's catalog:
Function | Purpose |
---|---|
GET {URI}/choiceProducts | Get all available Choice products. |
To filter the results, use the following query parameters with this endpoint:
Query params | Data type | Description |
---|---|---|
rewardName | string | Specify the reward name to be queried. |
currencyCode | string | Specify 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. |
countries | array of strings | Specify 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
Updated 7 days ago
What’s Next