A
A
API
Search…
A
A
API
Yumpu documentations
JS
Introduction
Quick setup
Magazine example's
Bookshelf example's
FAQs
API
Introduction
Getting started
Limits
Flowchart of basic processes
Documents
Document
Document hotspots
Document hotspot
Document progress
Document categories
Document languages
Countries
Get
Collections
Collection
Section
Section document
Search
User
Embeds
Embed
Members
Member
Access tags
Access tag
Subscriptions
Subscription
Powered By GitBook
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" "https://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
{
697
"iso": "SN",
698
"name": "Senegal"
699
},
700
{
701
"iso": "RS",
702
"name": "Serbia"
703
},
704
{
705
"iso": "CS",
706
"name": "Serbia and Montenegro"
707
},
708
{
709
"iso": "SC",
710
"name": "Seychelles"
711
},
712
{
713
"iso": "SL",
714
"name": "Sierra Leon"
715
},
716
{
717
"iso": "SG",
718
"name": "Singapore"
719
},
720
{
721
"iso": "SK",
722
"name": "Slovakia"
723
},
724
{
725
"iso": "SI",
726
"name": "Slovenia"
727
},
728
{
729
"iso": "SB",
730
"name": "Solomon Islands"
731
},
732
{
733
"iso": "SO",
734
"name": "Somalia"
735
},
736
{
737
"iso": "ZA",
738
"name": "South Africa"
739
},
740
{
741
"iso": "GS",
742
"name": "South Georgia and the South Sandwich Islands"
743
},
744
{
745
"iso": "ES",
746
"name": "Spain"
747
},
748
{
749
"iso": "LK",
750
"name": "Sri Lanka"
751
},
752
{
753
"iso": "SR",
754
"name": "Suriname"
755
},
756
{
757
"iso": "SJ",
758
"name": "Svalbard and Jan Mayen"
759
},
760
{
761
"iso": "SZ",
762
"name": "Swaziland"
763
},
764
{
765
"iso": "SE",
766
"name": "Sweden"
767
},
768
{
769
"iso": "CH",
770
"name": "Switzerland"
771
},
772
{
773
"iso": "TW",
774
"name": "Taiwan"
775
},
776
{
777
"iso": "TJ",
778
"name": "Tajikistan"
779
},
780
{
781
"iso": "TZ",
782
"name": "Tanzania"
783
},
784
{
785
"iso": "TH",
786
"name": "Thailand"
787
},
788
{
789
"iso": "TG",
790
"name": "Togo"
791
},
792
{
793
"iso": "TK",
794
"name": "Tokelau"
795
},
796
{
797
"iso": "TO",
798
"name": "Tonga"
799
},
800
{
801
"iso": "TT",
802
"name": "Trinidad and Tobago"
803
},
804
{
805
"iso": "TN",
806
"name": "Tunisia"
807
},
808
{
809
"iso": "TR",
810
"name": "Turkey"
811
},
812
{
813
"iso": "TM",
814
"name": "Turkmenistan"
815
},
816
{
817
"iso": "TC",
818
"name": "Turks and Caicos Islands"
819
},
820
{
821
"iso": "TV",
822
"name": "Tuvalu"
823
},
824
{
825
"iso": "UG",
826
"name": "Uganda"
827
},
828
{
829
"iso": "UA",
830
"name": "Ukraine"
831
},
832
{
833
"iso": "AE",
834
"name": "United Arab Emirates"
835
},
836
{
837
"iso": "GB",
838
"name": "United Kingdom"
839
},
840
{
841
"iso": "US",
842
"name": "United States"
843
},
844
{
845
"iso": "UM",
846
"name": "United States Minor Outlying Islands"
847
},
848
{
849
"iso": "UY",
850
"name": "Uruguay"
851
},
852
{
853
"iso": "UZ",
854
"name": "Uzbekistan"
855
},
856
{
857
"iso": "VU",
858
"name": "Vanuatu"
859
},
860
{
861
"iso": "VA",
862
"name": "Vatican City"
863
},
864
{
865
"iso": "VE",
866
"name": "Venezuela"
867
},
868
{
869
"iso": "VN",
870
"name": "Vietnam"
871
},
872
{
873
"iso": "VG",
874
"name": "Virgin Islands, British"
875
},
876
{
877
"iso": "WF",
878
"name": "Wallis and Futuna"
879
},
880
{
881
"iso": "EH",
882
"name": "Western Sahara"
883
},
884
{
885
"iso": "YE",
886
"name": "Yemen"
887
},
888
{
889
"iso": "ZM",
890
"name": "Zambia"
891
},
892
{
893
"iso": "ZW",
894
"name": "Zimbabwe"
895
}
896
],
897
"state": "success",
898
"completed_in": 0.0103
899
}
Copied!
API - Previous
Countries
Next - API
Collections
Last modified 4mo ago
Copy link
Contents
Retrieve a list of our countries
Demo