Change history

10/23/2025

Added validation logic to the POST {URI}/asyncOrders endpoint to prevent duplicate externalRefID usage, thereby avoiding duplicate order submissions. See Create async orders.

CODOR-472

10/23/2025

• Added referenceLineItemID to the POST /orders return payload to uniquely identify a reward transaction or line item within an order. See Reference line item ID and how to Create an order under a specific account.
• Added referenceOrderID in GET {URI}/orders/{referenceOrderID} to identify the order better when retrieving it. If an order has more than one line item, the API returns the referenceLineItemID for the first line item (lineNumber == 1). See Get details for a specific order.

CODOR-732

10/20/2025

🚧(Coming soon) For asynchronous orders, the return payload displays the total amount charged at the order level, making it easier to determine the total amount charged without summing the paginated line items. See return payload in Get a list of async orders , Get async orders status, and Get async line item details.

CODOR-419

10/16/2025

🚧( Coming soon) Added logic so that the template ID (ETID) is optional for email and mobile orders. In POST {URI}/asyncOrders if ETID is not provided, the system uses the default ETID configured in the following order: account, group, or platform level. If no default ETID is found, the standard template ID (E000000) is used. See Create async orders.

CODOR-455

10/16/2025

🚧( Coming soon) Added the following query parameters to GET async orders and GET async line items for better filtering: externalLineItemReferenceIds, referenceLineItemIds, and failedOnly. See Get async order status and Get async line item details.

CODOR-697

10/10/2025

Implemented logic in line item reissue to ensure that mobile delivery is only allowed if the MOBILE_DELIVERY feature is enabled for the account. If a mobile delivery is requested and the feature is disabled, an error will be thrown. The change is expected to benefit both the portal and the API. See Reissue line items.

CODOR-335

10/10/2025

Updated POST {URI}/lineItems/{referenceLineItemID}/reissue to support switching delivery methods between EMAIL and PHONE. If no delivery method is provided, the original order's delivery method will be used. See Reissue line items.

CODOR-277

10/08/2025

Added "Reason" list to the line items for resending rewards. The list includes: NOT_RECEIVED, LOST_DELETED, DELIVERY_INFO, DELIVERY_METHOD, REMINDER, and OTHER. See Get all reason codes.

CODOR-521

10/08/2025

🚧( Coming soon) Added PATCH to async orders to modify order metadata details such as Purchase Order Number, Campaign, and Order Notes. See update Async orders.

CODOR-441

10/08/2025

Modified the AsyncOrderStatus webhook event to include the following identifiers in the payload response: customerIdentifier, accountIdentifier, and referenceOrderID. See Asynchronous order status.

CODOR-444

10/08/2025

🚧( Coming soon) Created the GET {URI}/asyncOrders endpoint to retrieve all asynchronous orders placed on your platform with robust filtering and pagination capabilities. See Get a list of async orders.

CODOR-433

10/8/2025

Enabled API to reissue a line item by introducing POST {URI}/lineItems/{referenceLineItemID}/reissue. See Reissue line items.

CODOR-134

10/8/2025

Added Tango API webhook notification for account transactions, which helps automate tracking of fund movements. See Transactions under supported webhooks.

CODOR-90

10/8/2025

Enhance the Tango API by including resend delivery history in the line items payload response, allowing users to track reward resends. See Get details for a specific line item.

CODOR-210

10/01/2025

Fixed the line-item resend to use the original delivery method if no other method is specified. See Resend line items.

CODOR-710

8/5/2025

Added new query parameters to filter or search orders by deliveryStatus, deliveryMethod, and recipientMobileNumber. See Get line items.

API-606

7/28/2025

Enhanced the line items resend: POST {URI}/lineItems/{referenceLineItemId}/resendsto include the reason code as the body parameter when resending a reward. See Resend a line item.

API-663

7/23/2025

Added externalRefID to the RewardStatus event payload to match the event with your original request and improve tracking across your systems. See Reward status payload.

API-700

7/14/2025

Added the ability to update the low balance alerts via PATCH /customers/{customerIdentifier}/accounts/{accountIdentifier}/ lowbalance/{balanceAlertID}. This helps improve the management of low-balance alerts via the API. See how you can Update low balance alerts.

API_659

7/10/2025

Enforced validation of delivery methods based on delivery attributes associated with the reward UTID. Each UTID is linked to a set of eligible delivery methods. A UTID is eligible for PHONE delivery if its attribute includes PHONE. The system will reject the resend for deliveryMethod=ADDRESS, if ADDRESS is not among the UTID's eligible delivery methods.

API-627

7/7/2025

Added the ability to retrieve a list of low balance alerts for a customer account by calling GET /customers/{customerIdentifier}/accounts/{accountIdentifier}/ lowbalance endpoint. This enhancement improves the monitoring and management of account balances through the API. See View low balance alerts.

API-660

7/7/2025

🆕 Introduced the APICredentials webhook event under PLATFORM category to notify users when the API credentials are created, viewed, updated, or deleted. This improves the security and real-time monitoring of the API. See Platform category events.

API-539

7/1/2025

Added the ability to search the catalog for a specific attribute. See Get all items in the platform catalog.

API-665

7/1/2025

Enhanced the order processing logic: previously, the system determined if an order was for physical delivery based on the presence of a recipient address. The new logic requires the API to use the deliveryMethod field instead. See POST orders for when you create an order.

API-653

6/27/2025

🆕 Enhanced the "campaign" field to accept any character (including special characters), similar to the NOTES and MESSAGE fields. The field length is set to 1024 characters. See Orders and Line Items .

API-651

6/27/2025

Added smsMessageBody to POST {URI}/emailTemplates and PATCH {URI}/emailTemplates/{etid} endpoints to be able to create an SMS message body for PHONE delivery as an option. See Create a new email template and Update details for a specific email template.

API-614

6/26/2025

Created the ability to get a specific low balance alert via the API by using GET {URI}/customers/{customerIdentifier}/accounts/{accountIdentifier}/ lowbalance/{balanceAlertID}. See View details of a low balance alert.

API-661

6/24/2025

Created the ability to delete a specific low balance alert via the API by using DELETE {URI}/customers/{customerIdentifier}/accounts/{accountIdentifier}/ lowbalance/{balanceAlertID}. See Delete low balance alerts.

API-662

6/9/2025

Created the ability to set a low balance alert

API-654

5/14/2025

Added service account (username and password) as an additional security level to the OAuth connection. As of May 14, 2025, the Tango API will require a client ID, a client secret, a service account username, and a service account password to generate an access token via OAuth. See Use OAuth for more secure connection.

5/7/2025

Added Transaction eventType to the Account category in supported webhooks. Webhook events are sent when funds are added, removed, or transferred to or from your Tango account. See about Transaction.

API-328

5/7/2025

Added rewardType query parameter to GET {URI}/catalogs to enhance querying flexibility for users who access the Tango catalog. See Get all items in the platform catalog.

API-573

5/7/2025

Added the new GET {URI}/webhooks/eventtypes endpoint to webhooks to list all event types offered in the system for subscription. See Get all subscription event types.

API-271

5/1/2025

Updated recipient's physical address fields to include new characters such as &, %, #, @ in the POST {URI}/orders. See Create an order under a specific account.

API-437

5/7/2025

Added rewardType query parameter to GET {URI}/catalogs to enhance the catalog search. See Get all items in the platform catalog.

API-573

5/7/2025

Modified POST {URI}/orders/{referenceOrderID}/resends to allow for PHONE delivery when resending a specific order by adding newDeliveryMethod and newMobile as body parameters. We will support different delivery methods, including NONE, EMAIL, PHONE, and EMBEDDED. See Resend a specific order.

API-564

5/7/2025

Added the ability to deliver rewards via PHONE by adding deliveryMethod to POST {URI}/orders. See Create an order under a specific account.

API-565

5/7/2025

Added PHONE parameter to GET {URI}/orders payload to include deliveryMethod , recipientMobileNumber , and deliveryStatus in the payload. This change improves the flexibility and options for order delivery. See Get a list of orders placed on this platform.

API-562

5/7/2025

Added PHONE parameters to GET {URI}/lineItems payload to include deliveryMethod , recipientMobileNumber , and deliveryStatus in the payload. This change enhances the delivery options available to users and retrieves and filters the information about all line items ordered on the platform. See Get line items.

API-563

4/30/25

Added externalRefID to the POST {URI}/creditCardDeposits endpoint as an idempotent key support for funding cross-reference and to prevent accidental funding duplication. See Fund an account.

API-347

4/30/25

Added a body parameter: externalRefID to POST {URI}/transferFunds endpoint for funding cross-reference and to prevent accidental funding duplication. See Transfer funds.

API-389

4/17/2025

Added RewardStatus event type under Reward category in supported webhooks that sends notifications every time a reward status is changed. See Reward status.

API-540

3/27/2025

Emojis are not accepted for displayName or any text entry. See POST {URI}/customers in Create a new customer and POST {URI}/customers/{customerIdentifier}/accounts in Create an account under a specific customer.

API-363, API-549

3/26/2025

Added the new terminology for product release. See Release terminology in our Glossary.

3/26/2025

Added Line item delivery status for physical gift cards.

3/18/2025

Added i18nkey codes and their error messages to provide more specific error codes.

API-542

3/3/2025

We now accept Australian dollars (AUD) for Global Choice Link. To create an AUD account, see POST {URI}/customers/{customerIdentifier}/accounts. Other accepted currencies are CAD, EUR, GBP, or USD.

API-519

2/2025

🆕 Changed "Get line item" to Get details for a specific line item.

API-532

2/2025

🆕 Included error responses for Choice Products endpoints. See Manage Choice products endpoints.

API-482

2/2025

🆕 Included error responses for Credential Types endpoints. See Get credential types.

API-481

2/2025

🆕 Included error responses for Exchange Rates endpoints. See Get exchange rates.

API-480

2/2025

🆕 Included error responses for Email Templates endpoints. See Manage email templates endpoints.

API-479

2/2025

🆕 Included error responses for Orders endpoints. See Manage Orders endpoints.

API-477

2/2025

🆕 Included error responses for Catalog endpoints. See Get all items in the platform catalog.

API-476

2/21/2025

🆕 Included error responses for Fund endpoints. See Manage funds endpoints.

API-474

2/18/2025

Added a list of reasons for freeze, unfreeze, cancel, and reissue line items. Use GET {URI}/lineItems/reasonCodes to get the reason codes. See Get all reason codes.

API-506

2/18/2025

Added pagination to the list of customers when you use GET {URI}/customers. with this query parameter, you can receive a paginated payload helping you manage the results more effectively. See Get a list of all customers.

API-214

2/18/2025

Added pagination to the list of credit cards when you use GET {URI}/creditCards. with this query parameter, you can receive a paginated payload helping you manage the results more effectively. See List all credit cards registered on this platform.

API-218

2/18/2025

Added the ability to update line item parameters (purchase order number, campaign, and order notes) using PATCH /lineItems/ {referenceLineItemID}.

API-451

2/18/2025

Added query parameters to GET {URI}/customers. Filter by items such as display name, status, account number, and more. See Get a list of all customers .

API-213

2/18/2025

Added capabilities to freeze, unfreeze, cancel, and reissue line items: -To cancel, callPOST /lineItems/{referenceLineItemID}/cancel. -To freeze, call POST /lineItems/{referenceLineItemID}/freeze. -To unfreeze, call POST /lineItems/{referenceLineItemID}/unfreeze. -To reissue, call POST /lineItems/{referenceLineItemID}/reissue.

API-462 API-463 API-464 API-508

12/3/2024

IncludedrewardStatus in the payload of GET {URI}/lineItems to indicates whether a reward is frozen or active.

API-422

12/3/2024

IncludedisExpirable in the payload of GET {URI}/choiceProducts/{choiceProductUtid}/catalog and GET {URI}/catalogs to indicate whether or not the gift card has a expiry date. isExpirable is a boolean with true or false value.

API-224

10/16/2024

Updated OAuth 2.0 with a note: "When you deactivate a client credential, all active tokens for this client will become invalid and your integration will be broken. Deactivation cannot be reversed." OAuth 2.0 is currently on a limited release.

9/30/2024

Added account statuses such as Active, Inactive, etc. to the webhook event: AccountStatus.

8/15/2024

Deprecated credentials and added a note to use credentialList instead.

4/8/2024

Added a new endpoint to filter your catalog for your recipients based on country and currency . Use the GET /rewardCountries endpoint to determine the preferred currency.

API-373

3/25/2024

Added a new parameter to use with POST {URI}/orders/{referenceOrderID}/resends for when you are resending an order .

3/15/2024

Improved the results of GET {URI}/accounts by adding more query parameters .

API-211

2/20/2024

Added ability to categorize each brand into industry-standard categories within the Tango catalog and group/filter the brand in your custom catalog display. See categoryIds .

API-241

2/13/2024

Added fundingNotification body parameter to POST {URI}/customers/{customerIdentifier}/accounts endpoint to be able to add 1 to 5 email addresses to your account when crating an account. See Create an account under a specific customer. Added fundingNotification body parameter to PATCH {URI}/customers/{customerIdentifier}/accounts/{accountIdentifier} endpoint to be able to add 1 to 5 email addresses to your account when updating an account. See

Update an account under a specific customer .

API-334

2/8/2024

Improved the results of GET {URI}/creditCards by adding optional query parameters under funding account .

API-345

2/8/2024

Added currency type. Use the currencyCode body parameter with POST {URI}/customers/{customerIdentifier}/accounts to be able to create an account for a specific customer in any of these supported currencies: CAD, EUR, GBP, and USD. See Create an account under a specific customer.

API-338

1/29/2024

Added the ability to transfer funds from one account to another account of the same currency using GET {URI}/transferFunds.

API-240

2023

10/23/2023

Added GET /webhooks/{webhookId}/events?fromRevision={fromRevision}&toRevision={toRevision}&maxResultsint32={maxResultsint32} to receive all past event notifications up to three months. This feature is available in limited release, contact your Customer Success Manager (CSM) or [email protected] for more information.

API-269

10/17/2023

Added POST /webhooks/{webhookId}/replay?fromRevision={fromRevision}&toRevision={toRevision} to redeliver past webhook event notifications up to Three months. Notifications older than three months are not retrievable. This feature is available in limited release, contact your Customer Success Manager (CSM) or [email protected] for more information.

API-270

10/12/2023

Added GET {URI}/choiceProducts/{choiceProductUtid}/catalog to get the content of a Tango Choice catalog. You must have access to the Catalog to see the content.

API-293

10/12/2023

You can get all available Choice Products in your Tango catalog using GET {URI}/choiceProducts to returns utid.

API-294

10/12/2023

Added GET {URI}/choiceProducts/{utid} to return the details for a specific Choice Product on your Tango platform.

API-313

10/11/2023

Added the ability to set a specific expiration date, such as 12/31/24, for a Promo Link at the time of order with Tango API instead of setting the expiration date as x days from the time of issuance. See the Promo Link acceptance criteria .

API-320

10/7/2023

Categories have a Universal Unique Identifier (UUID). You can filter a catalog by category using GET {URI}//brandCategories.

API-306

10/5/2023

Added the ability to order a Printed Reward Link using GET {URI}/lineItems when you Get a list of line items and GET {URI}/lineItems/{referenceLineItemID} when you Get details for a specific line item .

API-305

9/28/2023

Added the ability to modify the recipient address object to be included in all returning payloads of line items, as well as in any query parameters that can filter and search the recipient information.

API-290

9/27/2023

Added ptid to GET {URI}/ordersso you can get the list of Printed Reward Link orders.

API-304

9/26/2023

Added ptid to POST {URI}/orders so you can create Printed Reward Link orders.

API-303

9/15/2023

Added orderNotes GET {URI}/lineItems to see your order notes in both API and in the

Tango portal line items history

.

API-295

9/15/2023

Added purchaseOrderNumber to order and line items. You are now able to include a PO Number when creating an order.

API-291

8/18/2023

Added filters for one or more currencies when using the exchange rate endpoint.

API-282

6/16/2023

Added OAuth authentication.

5/1/2023

Added query parameters to "Get a list of Orders" and added pagination to "Get a list of Accounts".

2022

12/22/2022

Exposed the GET /credentialtypes endpoint on the Test Console.

12/21/2022

Added line items endpoints:

• GET {URI}/lineItems to get a list of line items in the platform.
• GET {URI}/lineItems/{referenceLineItemID}to get details for a specific line item.
• POST {URI}/lineItems/{referenceLineItemId}/resends to resend a specific line item.

8/23/2021

Added GET /catalogs endpoint filters for utid, brandKey, currencyCode and country.

1/14/2021

Added API Reference to primary drop down.

7/15/2019

Added Glossary to the API documentation. (work in progress)

11/29/2018

Removed non-active cards from GET creditCards default response. Must use "?showInactive=true" to see inactive cards.

11/1/2018

Added Managing Email Templates for new API endpoints.

8/6/2018

Added note to clarify 4 digit security code require for Amex for test environment funding.

7/19/2018

Added credentialType to improve reward credential parsing.

4/18/2018

Added XSS and malicious behavior prevention note.

4/12/2018

Added SSL cert examples.

4/6/2018

Added email receipts information in Funding.

3/29/2018

Returned ETID in the API order response. Without a custom template defined, Tango default template ID: E000000 is returned.

3/29/2018

Included i18nKey in error responses which serves as a unique error code to facilitate international translations.

2/28/2018

Added clarification regarding how "Pending funding" status works. Provided $5.55 and $6.55 test amounts in sandbox.

1/23/2018

Updated: Group in Tango portal is calledCustomer in API.