---
updatedAt: 2025-10-23T05:34:33.000Z
---

# Reference Data - Retrieve Countries ISO3 - isoCode

```json JSON
curl --request GET \
     --url 'https://sandboxapi.moneygram.com/reference-data/v1/countries/USA?targetAudience=AGENT_FACING&agentPartnerId=30150519&userLanguage=EN-US' \
     --header 'X-MG-ClientRequestId: 4c79b06f-a2af-4859-82c8-28cbb0bf361b' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer T3ZAP8Kc9MFdPnuGy5YjGvdQ0Kr7'
```

```node Node
import moneygramDeveloper from '@api/moneygram-developer';

moneygramDeveloper.auth('T3ZAP8Kc9MFdPnuGy5YjGvdQ0Kr7');
moneygramDeveloper.country({
  targetAudience: 'AGENT_FACING',
  agentPartnerId: '30150519',
  userLanguage: 'EN-US',
  iso3Code: 'USA',
  'X-MG-ClientRequestId': '4c79b06f-a2af-4859-82c8-28cbb0bf361b'
})
  .then(({ data }) => console.log(data))
  .catch(err => console.error(err));
```

```python Python
import requests

url = "https://sandboxapi.moneygram.com/reference-data/v1/countries/USA?targetAudience=AGENT_FACING&agentPartnerId=30150519&userLanguage=EN-US"

headers = {
    "accept": "application/json",
    "X-MG-ClientRequestId": "4c79b06f-a2af-4859-82c8-28cbb0bf361b",
    "authorization": "Bearer T3ZAP8Kc9MFdPnuGy5YjGvdQ0Kr7"
}

response = requests.get(url, headers=headers)

print(response.text)
```

```java Java
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://sandboxapi.moneygram.com/reference-data/v1/countries/USA?targetAudience=AGENT_FACING&agentPartnerId=30150519&userLanguage=EN-US")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("X-MG-ClientRequestId", "4c79b06f-a2af-4859-82c8-28cbb0bf361b")
  .addHeader("authorization", "Bearer T3ZAP8Kc9MFdPnuGy5YjGvdQ0Kr7")
  .build();

Response response = client.newCall(request).execute();
```

```json Response Example
[
  {
    "iso3Code": "USA",
    "iso2Code": "US",
    "name": "United States of America",
    "baseCurrency": "USD",
    "sendActive": true,
    "receiveActive": true,
    "indicativeRateActive": false,
    "active": false,
    "sendCurrencies": [
      "USD"
    ],
    "receiveCurrencies": [
      "USD"
    ],
    "phoneDialCodes": [
      "1"
    ],
    "subdivisions": [
      {
        "code": "US-AK",
        "name": "Alaska"
      },
      {
        "code": "US-AL",
        "name": "Alabama"
      },
      {
        "code": "US-AR",
        "name": "Arkansas"
      },
      {
        "code": "US-AZ",
        "name": "Arizona"
      },
      {
        "code": "US-CA",
        "name": "California"
      },
      {
        "code": "US-CO",
        "name": "Colorado"
      },
      {
        "code": "US-CT",
        "name": "Connecticut"
      },
      {
        "code": "US-DC",
        "name": "District of Columbia"
      },
      {
        "code": "US-DE",
        "name": "Delaware"
      },
      {
        "code": "US-FL",
        "name": "Florida"
      },
      {
        "code": "US-GA",
        "name": "Georgia"
      },
      {
        "code": "US-HI",
        "name": "Hawaii"
      },
      {
        "code": "US-IA",
        "name": "Iowa"
      },
      {
        "code": "US-ID",
        "name": "Idaho"
      },
      {
        "code": "US-IL",
        "name": "Illinois"
      },
      {
        "code": "US-IN",
        "name": "Indiana"
      },
      {
        "code": "US-KS",
        "name": "Kansas"
      },
      {
        "code": "US-KY",
        "name": "Kentucky"
      },
      {
        "code": "US-LA",
        "name": "Louisiana"
      },
      {
        "code": "US-MA",
        "name": "Massachusetts"
      },
      {
        "code": "US-MD",
        "name": "Maryland"
      },
      {
        "code": "US-ME",
        "name": "Maine"
      },
      {
        "code": "US-MI",
        "name": "Michigan"
      },
      {
        "code": "US-MN",
        "name": "Minnesota"
      },
      {
        "code": "US-MO",
        "name": "Missouri"
      },
      {
        "code": "US-MS",
        "name": "Mississippi"
      },
      {
        "code": "US-MT",
        "name": "Montana"
      },
      {
        "code": "US-NC",
        "name": "North Carolina"
      },
      {
        "code": "US-ND",
        "name": "North Dakota"
      },
      {
        "code": "US-NE",
        "name": "Nebraska"
      },
      {
        "code": "US-NH",
        "name": "New Hampshire"
      },
      {
        "code": "US-NJ",
        "name": "New Jersey"
      },
      {
        "code": "US-NM",
        "name": "New Mexico"
      },
      {
        "code": "US-NV",
        "name": "Nevada"
      },
      {
        "code": "US-NY",
        "name": "New York"
      },
      {
        "code": "US-OH",
        "name": "Ohio"
      },
      {
        "code": "US-OK",
        "name": "Oklahoma"
      },
      {
        "code": "US-OR",
        "name": "Oregon"
      },
      {
        "code": "US-PA",
        "name": "Pennsylvania"
      },
      {
        "code": "US-RI",
        "name": "Rhode Island"
      },
      {
        "code": "US-SC",
        "name": "South Carolina"
      },
      {
        "code": "US-SD",
        "name": "South Dakota"
      },
      {
        "code": "US-TN",
        "name": "Tennessee"
      },
      {
        "code": "US-TX",
        "name": "Texas"
      },
      {
        "code": "US-UT",
        "name": "Utah"
      },
      {
        "code": "US-VA",
        "name": "Virginia"
      },
      {
        "code": "US-VT",
        "name": "Vermont"
      },
      {
        "code": "US-WA",
        "name": "Washington"
      },
      {
        "code": "US-WI",
        "name": "Wisconsin"
      },
      {
        "code": "US-WV",
        "name": "West Virginia"
      },
      {
        "code": "US-WY",
        "name": "Wyoming"
      }
    ]
  }
]
```

# 8

<!-- json@2 -->
<!-- node@6 -->
<!-- python@3 -->
<!-- java@4 -->

The application must provide the `iso3Code` as a path parameter.