# Western Union APIs

We've added several [APIs](https://nymcard.com/docs/api#tag/Western-Union) to API catalog, which are used for integration with Wester Union.

{% hint style="info" %}
Note, that these APIs are for Sandbox & Staging testing.
{% endhint %}

Below you can find detailed information regarding the following APIs:

* ["Get delivery option template"](#get-delivery-option-template-api)
* ["Get cascade list values"](#get-cascade-list-values-api)

### "Get delivery option template" API

The "**description**" field in the response of this [API](https://nymcard.com/docs/api#tag/Western-Union/operation/getDeliveryOptionTemplate) can be divided in several following fields:

<figure><img src="https://3730541649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftelq9krTgSM8OvsHep7r%2Fuploads%2FLH2yWJWmUBwki8r6dH1s%2Fimage.png?alt=media&#x26;token=1c76331f-0b05-4c16-80a2-188d990c3fd9" alt=""><figcaption></figcaption></figure>

For example, the **AccountName** field is returned with the following description:&#x20;

{% code overflow="wrap" %}

```
<DESCRIPTION>receiver.bank_account.account_holder;Account Name; 35; 1563; Account Name required; 0; UPRSTRING; NL; 35;</DESCRIPTION>
```

{% endcode %}

The number of semicolon (;) will identify you the number of the fields.

The raw structure can be considered as follows for the above description:

{% code overflow="wrap" %}

```
<DESCRIPTION>Field1;Field2; Field3; Field4; Field5; Field6; Field7; Field8; Field9;< /DESCRIPTION>
```

{% endcode %}

The description of the delimiter can be defined as follows:

{% code overflow="wrap" %}

```
<DESCRIPTION>Xpath;label text; data length; field ID; is required(y/n); N/A; field type; new line; count of records for combo</DESCRIPTION>
```

{% endcode %}

The rest of the details will remain same like AIS.

{% hint style="info" %}
Important Note:

The presence of “NL” value in Field 7 denotes that the next record in the record-set is a new APN field. If this field is blank, partner needs to process and display the next records in the record-set till the next “NL” will be read as 1 APN field.
{% endhint %}

### "Get cascade list values" API

The **"firstLevelValue" & "secondLevelValue"** fields in this [API](https://nymcard.com/docs/api#tag/Western-Union/operation/getCascadeList) can be divided in several fields. It depends on the region. Below you can find an example (for Bangladesh):

<figure><img src="https://3730541649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftelq9krTgSM8OvsHep7r%2Fuploads%2FRu8pb6xbfzVpvQvQR7mF%2FScreen%20Shot%202023-07-04%20at%203.23.27%20PM.png?alt=media&#x26;token=e588313d-81e5-42ba-9360-536ef86ead3d" alt=""><figcaption></figcaption></figure>