API endpoint overview

Tango API has numerous endpoints to help you perform a variety of activities in your Tango platform. These endpoints are presented here at an overview level. For detailed information on each endpoint, refer to their related article in this guide.

📘

Notes:

• Tango API v2 is a RESTful JSON API.
• Tango API authentication is handled via HTTP Basic Auth or OAuth 2.0
• Sandbox URI: https://integration-api.tangocard.com/raas/v2
• Production URI: https://api.tangocard.com/raas/v2

Customers

Use the following endpoints to create and view customers (groups) on the platform. These calls include details for all customers and accounts under a platform but not the balance and contact information for the accounts.

For details, refer to our document on Manage customers.

Accounts

Use the following endpoints to get detailed information, such as balance, for the accounts in your platform.

For details, refer to our document on Manage accounts.

Fund

Use the following endpoints to register, fund, and un-register credit cards.

For details, refer to our document on Fund your account.

Credential types

Use GET {URI}/credentialtypes to get a list of credential types. There is no parameters for this endpoint.

For details, refer to our document on Get credential types.

Orders

Use the following endpoints to create, view, and resend orders.

For details. refer to our document on Manage orders.

Catalogs

Use the following endpoint to view the items in your catalog, along with the details to order items and display the item information.

📘

Note:

UTID is Unique Tango ID {{utid}} for the item being ordered such as Gift Cards or NPO or nonprofit donations.

For details, refer to our document on Manage catalog.

Brand categories

Use the following endpoint to filter a catalog by category such as grocery, beauty, health and wellness, etc. Categories have a Universal Unique Identifier (UUID).

For details, refer to our document Get brand categories.

Choice products

Use the following endpoint to manage Choice Products such as: Reward Link® (RL), Promo Link ™(PL), and Disbursement Link (DL).

For details, refer to our document Manage Choice products.

Countries and currencies

Use the following endpoints to get a list of countries and their preferred currency:

For details, refer to our document Manage countries and currencies.

Email templates

Use the following endpoints to create, view, update and delete email templates for reward delivery.

For details, refer to our document on Manage email templates.

Line items

Orders consist of one or more line items. Each line item represents a single gift card, reward, disbursement, or promotional link and has its unique reference number, customer's first name, last name, email address, dollar amount, etc. Each line item can be managed separately when a request fails due to an undeliverable email or a misspelled recipient's name, for example.

Use the following endpoints to page through or filter a list of line items, including their non-sensitive details and reward status. You can also view details for a specific line item, including sensitive details, reward history, reward redemption, or resend a specific line item.

For details, refer to our document on Manage line items.

Exchange rates

Use GET {URI}/exchangerates endpoint to provide a list of exchange rates currently set in the Tango system. Use the following endpoint to calculate the cost of international rewards.

For details, refer to our document on Get exchange rates.

Webhooks

We support webhooks in or API. Check out Webhook endpoints for the latest.

Response codes

We provide the following response codes and messages in our API. For the health check of above functions, use '/pulse' endpoint to determine whether the system is healthy or not. When the response is 200, for example, the system is OK.

See Tango response classes for more information.