Host Countries
GET {{host}}/api/partner/product/{{product_id}}/host-countries
Use this to receive the list of home countries allowed for this product. The aliases should map to the country name, as well as the alternative_names. It also provides a list of states, if applicable.
Request URL Parameters
All the below are required.
| Key | Description | Example |
|---|---|---|
| product_id | Product ID. See product reference section. | 6 |
Response Body Parameters
The response will be an array of objects. Each object will have the below parameters:
| Key | Description | Example |
|---|---|---|
| id | Host country ID. | 1 |
| code | Country code in ISO 3166 alpha-2 format. | US |
| name | Country Name | United States |
| is_disabled | Boolean value that determines if the associated host country is disabled. | false |
| aliases | Array of objects which contain abbreviated aliases for a country. | [ { alias: USA } ], |
| alternative_names | Array of objects which contain alternative names for a country. | [ { name: Alabama }, ] |
| states | See states reference below. |
States
| Key | Description | Example |
|---|---|---|
| id | Host country state ID | 1 |
| code | 3 letter code for state in ISO 3166-1 alpha 3 standard. Can also be an empty string for non-applicable countries. https://www.iso.org/obp/ui/#iso:code:3166:US | VIC |
| name | State name | Victoria |
| is_disabled | Boolean value that determines if the associated host country is disabled. | false |