# 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="/files/nqZUKan2NX87FlIqcyw0" 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="/files/NmAdvlQLnHM2IKudSgbQ" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nymcard.com/get-started/funding-and-transfers/western-union-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.