A
A
API
Search…
Get

Retrieve a list of our countries

Demo

URL Find your token on - yumpu.com Token
Run request
1
Copied!
curl
PHP
JavaScript
Java
Example:
1
curl -X GET -H "X-ACCESS-TOKEN: YOUR_ACCESS_TOKEN" "http://api.yumpu.com/2.0/countries.json"
Copied!
Example:
1
require_once('../yumpu.php');
2
$yumpu = new Yumpu();
3
$countries = $yumpu->getCountries();
4
print_r($countries);
Copied!
Example:
1
var yumpu = require('yumpu');
2
yumpu.setToken('yourToken');
3
yumpu.getCountries(function(statusCode, document){
4
console.log('Status: ' + statusCode);
5
console.log(document);
6
});
Copied!
Example:
1
Yumpu y = new Yumpu("your access token");
2
System.out.println(y.getCountries());
Copied!
Whatever language you are using, the result will be the same.
1
{
2
"total": 223,
3
"countries": [
4
{
5
"iso": "AF",
6
"name": "Afghanistan"
7
},
8
{
9
"iso": "AL",
10
"name": "Albania"
11
},
12
{
13
"iso": "DZ",
14
"name": "Algeria"
15
},
16
{
17
"iso": "AD",
18
"name": "Andorra"
19
},
20
{
21
"iso": "AO",
22
"name": "Angola"
23
},
24
{
25
"iso": "AI",
26
"name": "Anguilla"
27
},
28
{
29
"iso": "AQ",
30
"name": "Antarctica"
31
},
32
{
33
"iso": "AG",
34
"name": "Antigua and Barbuda"
35
},
36
{
37
"iso": "AR",
38
"name": "Argentina"
39
},
40
{
41
"iso": "AM",
42
"name": "Armenia"
43
},
44
{
45
"iso": "AW",
46
"name": "Aruba"
47
},
48
{
49
"iso": "AU",
50
"name": "Australia"
51
},
52
{
53
"iso": "AT",
54
"name": "Austria"
55
},
56
{
57
"iso": "AZ",
58
"name": "Azerbaijan"
59
},
60
{
61
"iso": "BS",
62
"name": "Bahamas"
63
},
64
{
65
"iso": "BH",
66
"name": "Bahrain"
67
},
68
{
69
"iso": "BD",
70
"name": "Bangladesh"
71
},
72
{
73
"iso": "BB",
74
"name": "Barbados"
75
},
76
{
77
"iso": "BY",
78
"name": "Belarus"
79
},
80
{
81
"iso": "BE",
82
"name": "Belgium"
83
},
84
{
85
"iso": "BZ",
86
"name": "Belize"
87
},
88
{
89
"iso": "BJ",
90
"name": "Benin"
91
},
92
{
93
"iso": "BM",
94
"name": "Bermuda"
95
},
96
{
97
"iso": "BT",
98
"name": "Bhutan"
99
},
100
{
101
"iso": "BO",
102
"name": "Bolivia"
103
},
104
{
105
"iso": "BA",
106
"name": "Bosnia and Herzegovina"
107
},
108
{
109
"iso": "BW",
110
"name": "Botswana"
111
},
112
{
113
"iso": "BR",
114
"name": "Brazil"
115
},
116
{
117
"iso": "IO",
118
"name": "British Indian Ocean"
119
},
120
{
121
"iso": "BN",
122
"name": "Brunei"
123
},
124
{
125
"iso": "BG",
126
"name": "Bulgaria"
127
},
128
{
129
"iso": "BF",
130
"name": "Burkina Faso"
131
},
132
{
133
"iso": "BI",
134
"name": "Burundi"
135
},
136
{
137
"iso": "KH",
138
"name": "Cambodia"
139
},
140
{
141
"iso": "CM",
142
"name": "Cameroon"
143
},
144
{
145
"iso": "CA",
146
"name": "Canada"
147
},
148
{
149
"iso": "CV",
150
"name": "Cape Verde"
151
},
152
{
153
"iso": "KY",
154
"name": "Cayman Islands"
155
},
156
{
157
"iso": "CF",
158
"name": "Central African Republic"
159
},
160
{
161
"iso": "TD",
162
"name": "Chad"
163
},
164
{
165
"iso": "CL",
166
"name": "Chile"
167
},
168
{
169
"iso": "CN",
170
"name": "China"
171
},
172
{
173
"iso": "CX",
174
"name": "Christmas Island"
175
},
176
{
177
"iso": "CC",
178
"name": "Cocos (Keeling) Islands"
179
},
180
{
181
"iso": "CO",
182
"name": "Colombia"
183
},
184
{
185
"iso": "KM",
186
"name": "Comoros"
187
},
188
{
189
"iso": "CD",
190
"name": "Congo, Democratic Republic of the"
191
},
192
{
193
"iso": "CG",
194
"name": "Congo, Republic of the"
195
},
196
{
197
"iso": "CK",
198
"name": "Cook Islands"
199
},
200
{
201
"iso": "CR",
202
"name": "Costa Rica"
203
},
204
{
205
"iso": "HR",
206
"name": "Croatia"
207
},
208
{
209
"iso": "CY",
210
"name": "Cyprus"
211
},
212
{
213
"iso": "CZ",
214
"name": "Czech Republic"
215
},
216
{
217
"iso": "DK",
218
"name": "Denmark"
219
},
220
{
221
"iso": "DJ",
222
"name": "Djibouti"
223
},
224
{
225
"iso": "DM",
226
"name": "Dominica"
227
},
228
{
229
"iso": "DO",
230
"name": "Dominican Republic"
231
},
232
{
233
"iso": "TL",
234
"name": "East Timor"
235
},
236
{
237
"iso": "EC",
238
"name": "Ecuador"
239
},
240
{
241
"iso": "EG",
242
"name": "Egypt"
243
},
244
{
245
"iso": "SV",
246
"name": "El Salvador"
247
},
248
{
249
"iso": "GQ",
250
"name": "Equatorial Guinea"
251
},
252
{
253
"iso": "ER",
254
"name": "Eritrea"
255
},
256
{
257
"iso": "EE",
258
"name": "Estonia"
259
},
260
{
261
"iso": "ET",
262
"name": "Ethiopia"
263
},
264
{
265
"iso": "FK",
266
"name": "Falkland Islands (Malvinas)"
267
},
268
{
269
"iso": "FO",
270
"name": "Faroe Islands"
271
},
272
{
273
"iso": "FJ",
274
"name": "Fiji"
275
},
276
{
277
"iso": "FI",
278
"name": "Finland"
279
},
280
{
281
"iso": "FR",
282
"name": "France"
283
},
284
{
285
"iso": "GF",
286
"name": "French Guiana"
287
},
288
{
289
"iso": "PF",
290
"name": "French Polynesia"
291
},
292
{
293
"iso": "GA",
294
"name": "Gabon"
295
},
296
{
297
"iso": "GM",
298
"name": "Gambia"
299
},
300
{
301
"iso": "GE",
302
"name": "Georgia"
303
},
304
{
305
"iso": "DE",
306
"name": "Germany"
307
},
308
{
309
"iso": "GH",
310
"name": "Ghana"
311
},
312
{
313
"iso": "GI",
314
"name": "Gibraltar"
315
},
316
{
317
"iso": "GR",
318
"name": "Greece"
319
},
320
{
321
"iso": "GL",
322
"name": "Greenland"
323
},
324
{
325
"iso": "GD",
326
"name": "Grenada"
327
},
328
{
329
"iso": "GP",
330
"name": "Guadeloupe"
331
},
332
{
333
"iso": "GT",
334
"name": "Guatemala"
335
},
336
{
337
"iso": "GN",
338
"name": "Guinea"
339
},
340
{
341
"iso": "GW",
342
"name": "Guinea-Bissau"
343
},
344
{
345
"iso": "GY",
346
"name": "Guyana"
347
},
348
{
349
"iso": "HT",
350
"name": "Haiti"
351
},
352
{
353
"iso": "HN",
354
"name": "Honduras"
355
},
356
{
357
"iso": "HK",
358
"name": "Hong Kong"
359
},
360
{
361
"iso": "HU",
362
"name": "Hungary"
363
},
364
{
365
"iso": "IS",
366
"name": "Iceland"
367
},
368
{
369
"iso": "IN",
370
"name": "India"
371
},
372
{
373
"iso": "ID",
374
"name": "Indonesia"
375
},
376
{
377
"iso": "IE",
378
"name": "Ireland"
379
},
380
{
381
"iso": "IL",
382
"name": "Israel"
383
},
384
{
385
"iso": "IT",
386
"name": "Italy"
387
},
388
{
389
"iso": "CI",
390
"name": "Ivory Coast (Côte d\\'Ivoire)"
391
},
392
{
393
"iso": "JM",
394
"name": "Jamaica"
395
},
396
{
397
"iso": "JP",
398
"name": "Japan"
399
},
400
{
401
"iso": "JO",
402
"name": "Jordan"
403
},
404
{
405
"iso": "KZ",
406
"name": "Kazakhstan"
407
},
408
{
409
"iso": "KE",
410
"name": "Kenya"
411
},
412
{
413
"iso": "KI",
414
"name": "Kiribati"
415
},
416
{
417
"iso": "KR",
418
"name": "Korea, South"
419
},
420
{
421
"iso": "KW",
422
"name": "Kuwait"
423
},
424
{
425
"iso": "KG",
426
"name": "Kyrgyzstan"
427
},
428
{
429
"iso": "LA",
430
"name": "Laos"
431
},
432
{
433
"iso": "LV",
434
"name": "Latvia"
435
},
436
{
437
"iso": "LB",
438
"name": "Lebanon"
439
},
440
{
441
"iso": "LS",
442
"name": "Lesotho"
443
},
444
{
445
"iso": "LI",
446
"name": "Liechtenstein"
447
},
448
{
449
"iso": "LT",
450
"name": "Lithuania"
451
},
452
{
453
"iso": "LU",
454
"name": "Luxembourg"
455
},
456
{
457
"iso": "MO",
458
"name": "Macau"
459
},
460
{
461
"iso": "MK",
462
"name": "Macedonia, Republic of"
463
},
464
{
465
"iso": "MG",
466
"name": "Madagascar"
467
},
468
{
469
"iso": "MW",
470
"name": "Malawi"
471
},
472
{
473
"iso": "MY",
474
"name": "Malaysia"
475
},
476
{
477
"iso": "MV",
478
"name": "Maldives"
479
},
480
{
481
"iso": "ML",
482
"name": "Mali"
483
},
484
{
485
"iso": "MT",
486
"name": "Malta"
487
},
488
{
489
"iso": "MH",
490
"name": "Marshall Islands"
491
},
492
{
493
"iso": "MQ",
494
"name": "Martinique"
495
},
496
{
497
"iso": "MR",
498
"name": "Mauritania"
499
},
500
{
501
"iso": "MU",
502
"name": "Mauritius"
503
},
504
{
505
"iso": "YT",
506
"name": "Mayotte"
507
},
508
{
509
"iso": "MX",
510
"name": "Mexico"
511
},
512
{
513
"iso": "FM",
514
"name": "Micronesia"
515
},
516
{
517
"iso": "MD",
518
"name": "Moldova"
519
},
520
{
521
"iso": "MC",
522
"name": "Monaco"
523
},
524
{
525
"iso": "MN",
526
"name": "Mongolia"
527
},
528
{
529
"iso": "ME",
530
"name": "Montenegro"
531
},
532
{
533
"iso": "MS",
534
"name": "Montserrat"
535
},
536
{
537
"iso": "MA",
538
"name": "Morocco"
539
},
540
{
541
"iso": "MZ",
542
"name": "Mozambique"
543
},
544
{
545
"iso": "NA",
546
"name": "Namibia"
547
},
548
{
549
"iso": "NR",
550
"name": "Nauru"
551
},
552
{
553
"iso": "NP",
554
"name": "Nepal"
555
},
556
{
557
"iso": "NL",
558
"name": "Netherlands"
559
},
560
{
561
"iso": "AN",
562
"name": "Netherlands Antilles"
563
},
564
{
565
"iso": "NC",
566
"name": "New Caledonia"
567
},
568
{
569
"iso": "NZ",
570
"name": "New Zealand"
571
},
572
{
573
"iso": "NI",
574
"name": "Nicaragua"
575
},
576
{
577
"iso": "NE",
578
"name": "Niger"
579
},
580
{
581
"iso": "NG",
582
"name": "Nigeria"
583
},
584
{
585
"iso": "NU",
586
"name": "Niue"
587
},
588
{
589
"iso": "NF",
590
"name": "Norfolk Island"
591
},
592
{
593
"iso": "NO",
594
"name": "Norway"
595
},
596
{
597
"iso": "OM",
598
"name": "Oman"
599
},
600
{
601
"iso": "PK",
602
"name": "Pakistan"
603
},
604
{
605
"iso": "PS",
606
"name": "Palestinian Territory"
607
},
608
{
609
"iso": "PA",
610
"name": "Panama"
611
},
612
{
613
"iso": "PG",
614
"name": "Papua New Guinea"
615
},
616
{
617
"iso": "PY",
618
"name": "Paraguay"
619
},
620
{
621
"iso": "PE",
622
"name": "Peru"
623
},
624
{
625
"iso": "PH",
626
"name": "Philippines"
627
},
628
{
629
"iso": "PN",
630
"name": "Pitcairn Island"
631
},
632
{
633
"iso": "PL",
634
"name": "Poland"
635
},
636
{
637
"iso": "PT",
638
"name": "Portugal"
639
},
640
{
641
"iso": "QA",
642
"name": "Qatar"
643
},
644
{
645
"iso": "RE",
646
"name": "Réunion"
647
},
648
{
649
"iso": "RO",
650
"name": "Romania"
651
},
652
{
653
"iso": "RU",
654
"name": "Russia"
655
},
656
{
657
"iso": "RW",
658
"name": "Rwanda"
659
},
660
{
661
"iso": "SH",
662
"name": "Saint Helena"
663
},
664
{
665
"iso": "KN",
666
"name": "Saint Kitts and Nevis"
667
},
668
{
669
"iso": "LC",
670
"name": "Saint Lucia"
671
},
672
{
673
"iso": "PM",
674
"name": "Saint Pierre and Miquelon"
675
},
676
{
677
"iso": "VC",
678
"name": "Saint Vincent and the Grenadines"
679
},
680
{
681
"iso": "WS",
682
"name": "Samoa"
683
},
684
{
685
"iso": "SM",
686
"name": "San Marino"
687
},
688
{
689
"iso": "ST",
690
"name": "São Tome and Principe"
691
},
692
{
693
"iso": "SA",
694
"name": "Saudi Arabia"
695
},
696
{