Get - 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&ocirc;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&eacute;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&atilde;o Tome and Principe"
691
    },
692
    {
693
      "iso": "SA",
694
      "name": "Saudi Arabia"
695
    },
696
    {