Get details for a specific Choice product

This Tango API endpoint allows you to fetch metadata about a specific Choice Product—such as a gift card or nonprofit donation option—using its UTID (Unique Tango ID).

Use case

Acme Health runs a global employee‑recognition program and needs to ensure that rewards shown to employees are valid for their country and currency. When an employee selects a reward, Acme uses this endpoint to retrieve real‑time details—such as the reward name, currency, and the list of eligible countries. Acme then checks whether the employee’s country appears in the product’s countries list and whether the currency matches program requirements. Currencies are fixed per UTID and default to USD if unspecified.

If everything is valid, Acme allows the employee to proceed and then uses the same UTID for the final reward‑fulfillment API call. This ensures accurate, globally compliant reward offerings and reduces failed redemptions.

Endpoint

Use the following endpoint to return the details for a specific Choice Product on your Tango platform:

Parameters

The following path parameter is required for this endpoint. UTID is Unique Tango ID for the item being ordered such as gift cards or nonprofit donations.

Response body notes

On a successful request (200 OK), the response body returns many fields including utid, rewardName, currencyCode, and countries. The currencyCode is the currency associated with that specific Choice Product UTID.

Examples

The following payload example is returned with a 200 Ok for this endpoint:

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

The following payload example shows the available details such as currency and country for a specific UTID.

{
  "utid": "U431828",
  "rewardName": "Global Choice Link (SV CAD)",
  "currencyCode": "CAD",
  "countries": [
    "BE",
    "TH",
    "PL",
    "BG",
    "SE",
    "US",
    "BD",
    "ID",
    "ES",
    "MY",
    "GR",
    "CZ",
    "EG"
  ]
}

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": [
    {}
  ]
}

Response code

The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages: