PHP 7.3 reached end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in September 2022. You may want to consider planning your upgrade now to Adobe Commerce 2.4.x and PHP 7.4.x to help maintain PCI compliance.
countries query
The countries
query returns all countries in which the entity can do business.
Use the country query if you want to retrieve information about a specific country.
Syntax
{countries {Countries}}
Example usage
The following query returns all countries listed for the current instance of Magento:
Request:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
query {
countries {
id
two_letter_abbreviation
three_letter_abbreviation
full_name_locale
full_name_english
available_regions {
id
code
name
}
}
}
Response:
In this example, the response is intentionally truncated. The available_regions
attribute value will be null if the country does not have any regions available. Otherwise, it contains an array of the country’s regions.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
{
"data": {
"countries": [
{
"id": "AD",
"two_letter_abbreviation": "AD",
"three_letter_abbreviation": "AND",
"full_name_locale": "Andorra",
"full_name_english": "Andorra",
"available_regions": null
},
{
"id": "AE",
"two_letter_abbreviation": "AE",
"three_letter_abbreviation": "ARE",
"full_name_locale": "United Arab Emirates",
"full_name_english": "United Arab Emirates",
"available_regions": null
},
{
"id": "AF",
"two_letter_abbreviation": "AF",
"three_letter_abbreviation": "AFG",
"full_name_locale": "Afghanistan",
"full_name_english": "Afghanistan",
"available_regions": null
},
{
"id": "AG",
"two_letter_abbreviation": "AG",
"three_letter_abbreviation": "ATG",
"full_name_locale": "Antigua and Barbuda",
"full_name_english": "Antigua and Barbuda",
"available_regions": null
},
{
"id": "AT",
"two_letter_abbreviation": "AT",
"three_letter_abbreviation": "AUT",
"full_name_locale": "Austria",
"full_name_english": "Austria",
"available_regions": [
{
"id": 102,
"code": "BL",
"name": "Burgenland"
},
{
"id": 99,
"code": "KN",
"name": "Kärnten"
},
{
"id": 96,
"code": "NO",
"name": "Niederösterreich"
},
{
"id": 97,
"code": "OO",
"name": "Oberösterreich"
},
{
"id": 98,
"code": "SB",
"name": "Salzburg"
},
{
"id": 100,
"code": "ST",
"name": "Steiermark"
},
{
"id": 101,
"code": "TI",
"name": "Tirol"
},
{
"id": 103,
"code": "VB",
"name": "Vorarlberg"
},
{
"id": 95,
"code": "WI",
"name": "Wien"
}
]
}
]
}
}
Output attributes
The query returns an array of Country
objects.
Country attributes
Attribute | Data type | Description |
---|---|---|
available_regions |
[Region] | An array of regions within a particular country |
full_name_english |
String | The name of the country in English |
full_name_locale |
String | The locale name of the country |
three_letter_abbreviation |
String | The three-letter abbreviation of the country, such as USA |
two_letter_abbreviation |
String | The two-letter abbreviation of the country, such as US |
Region attributes
The Region
object provides the following attributes:
Attribute | Data type | Description |
---|---|---|
code |
String | The two-letter code for the region, such as TX for Texas |
id |
Int | A unique ID for the region |
name |
String | The name of the region, such as Texas |