Get credential types

We provide the ability to get all the credential types on your platform using credentialType endpoint. The results show definitions and detailed information about each credential type. It categorizes credential types based on internal factors of the Tango system and provides definitions that are often similar or identical. Some examples of credential types are: barcodeNumber, barcodeUrl, eventNumber, etc.

The GET {URI}/catalogs returns the credential types information for each item in the catalog. See how to Get all items in the platform catalog.

Get a list of credential types

The GET {URI}/credentialTypes call returns the list of credential types you might encounter on your platform. There is no parameters for this endpoint.

Endpoint	Purpose
`GET {URI}/credentialtypes`	Get a List of credential types

The following payload shows a list of credential types in a Tango platform using GET {URI}/credentialTypes endpoint:

[
  {
    "credentialType": "barcodeNumber",
    "description": "A numeric or alphanumeric string that provides a human readable version of the information embedded in a barcode. This is typically used in conjunction with the barcodeUrl credential."
  },
  {
    "credentialType": "barcodeUrl",
    "description": "A URL for a barcode image. This is typically used in conjunction with the barcodeNumber credential."
  },
  {
    "credentialType": "bypassUrl",
    "description": "A landing page URL that includes secondary credential information. This removes the need for the recipient to input secondary credentials on the landing page."
  },
  {
    "credentialType": "cardCode",
    "description": "A numeric or alphanumeric string."
  },
  {
    "credentialType": "cardNumber",
    "description": "A numeric or alphanumeric string."
  },
  {
    "credentialType": "cvc2",
    "description": "A 3-digit numeric code used as a secondary credential for financial products."
  },
  {
    "credentialType": "eventNumber",
    "description": "A secondary credential that is numeric or alphanumeric string."
  },
  {
    "credentialType": "expirationDate",
    "description": "A date after which the issued reward will no longer be redeemable."
  },
  {
    "credentialType": "pin",
    "description": "Personal Identification Number. A secondary credential that is a numeric or alphanumeric string."
  },
  {
    "credentialType": "redemptionUrl",
    "description": "A landing page URL where reward credentials and redemption information are typically presented. The landing page may or may not require the recipient to enter one or more secondary credentials to complete the reward redemption process."
  },
  {
    "credentialType": "secretCode",
    "description": "A secondary credential that is numeric or alphanumeric string."
  }
]

Reward types and credential types

Tango offers the following reward types and credential types. If your integration requires displaying reward data in app or creating custom reward emails, you may need to add logic to parse the returned reward data correctly.

📘
Note:
We are continuously expanding our catalog and it is likely that new reward types will arise over time. For this reason we recommend a fallback/default to handle unspecified types as text.

Reward type	Description	Credential type	Integration example
text	Plain text	cardNumber, PIN, securityCode, claimCode, etc.	Wrap in a `<span>` tag
URL	URL to a reward landing page	redemptionUrl, securityUrl	Wrap in an `<a>` tag
barcode	URL for a barcode image	barcode	Add an `<img>` tag
date	ISO datedtime	expirationDate	Display in localized date format based on locale of reward according to RFC 3339, such as 2016-01-01T00:00:00Z

Credential type key

For better parsing and display of reward data, we have added the credentialType key to the credentialList object in the Order response. See Get details for a specific order.

The following payload shows the credential types such as redemptionUrl or expirationDate as part of the credentialList object in the order response when performing the GET {URI}/orders/{referenceOrderID} call. To get details such as credentialType for a specific order, you must have referenceOrderID ready:

"credentialList": [
            {
                "label": "Redemption Link",
                "value": "https://sandbox.rewardlink.io/r/1/_KBqZ9x056xOCrp34qxM74R2KQqYJlHoaJKZAXbwkSQ",
                "type": "url",
                "credentialType": "redemptionUrl"
            },
            {
                "label": "Expiration",
                "value": "",
                "type": "date",
                "credentialType": "expirationDate"
            }

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 as follows. For details, see i18nkey codes and their error messages:

200 OK
400 Bad Request
401 Unauthorized
403 Forbidden

Get a list of credential types

Reward types and credential types

📘Note:

Credential type key

📘
Note: