High-Performance Flag API for Modern Developers

Lightning-fast vector flags for every country and territory. Delivered via global CDN completely free in pristine SVG format with zero limits.

terminal cURL Request (SVG Format) GET /us.svg

curl -X GET "https://flag.alfian.web.id/us.svg"

Built for Scale and Speed

Everything you need to integrate international flags into your web, mobile, or desktop applications seamlessly.

speed

Edge CDN Delivery

Cached globally across 250+ edge locations to guarantee sub-15ms response times anywhere in the world.

format_shapes

Pristine SVG Format

Exclusively served as clean, resolution-independent vector graphics that look flawless on any screen density.

update

Always Up-to-Date

Strictly complies with ISO 3166-1 alpha-2 codes, updated instantly with geopolitical shifts.

integration_instructions Integration Guide

How to Use Alfian Flag API

Embedding vector flags into your applications is as simple as referencing a direct URL or pulling data through your preferred programming language.

Use Standard ISO Codes

Reference flags using standard lowercase ISO alpha-2 codes (e.g., `us`, `ca`, `gb`) for reliable routing.

Reference SVG Directly

Use the endpoint URL straight inside an HTML image tag with the `.svg` extension for crisp vector quality on any display.

Scale with Edge Cache

Your users receive the flags from the closest global CDN node automatically with built-in compression and high availability.

Quick Code Implementation HTML & JS

&lt;!-- Direct SVG image implementation --&gt;
&lt;img src="https://flag.alfian.web.id/us.svg" 
     alt="US Flag" 
     width="32" 
     class="rounded shadow" /&gt;

&lt;!-- JavaScript Fetch Example --&gt;
&lt;script&gt;
  const country = "ca";
  fetch(`https://flag.alfian.web.id/${country}.svg`)
    .then(res => console.log(res.url));
&lt;/script&gt;

code API Directory

Supported Flag Endpoints

List of country codes and their matching SVG endpoints.

Base URL: https://flag.alfian.web.id

Country / Territory	Country Code	Endpoint
Afghanistan	AF	GET /AF.svg
Albania	AL	GET /AL.svg
Algeria	DZ	GET /DZ.svg
American Samoa	AS	GET /AS.svg
Andorra	AD	GET /AD.svg
Angola	AO	GET /AO.svg
Anguilla	AI	GET /AI.svg
Antarctica	AQ	GET /AQ.svg
Antigua and Barbuda	AG	GET /AG.svg
Argentina	AR	GET /AR.svg
Armenia	AM	GET /AM.svg
Aruba	AW	GET /AW.svg
Australia	AU	GET /AU.svg
Austria	AT	GET /AT.svg
Azerbaijan	AZ	GET /AZ.svg
Bahamas (the)	BS	GET /BS.svg
Bahrain	BH	GET /BH.svg
Bangladesh	BD	GET /BD.svg
Barbados	BB	GET /BB.svg
Belarus	BY	GET /BY.svg
Belgium	BE	GET /BE.svg
Belize	BZ	GET /BZ.svg
Benin	BJ	GET /BJ.svg
Bermuda	BM	GET /BM.svg
Bhutan	BT	GET /BT.svg
Bolivia (Plurinational State of)	BO	GET /BO.svg
Bonaire, Sint Eustatius and Saba	BQ	GET /BQ.svg
Bosnia and Herzegovina	BA	GET /BA.svg
Botswana	BW	GET /BW.svg
Bouvet Island	BV	GET /BV.svg
Brazil	BR	GET /BR.svg
British Indian Ocean Territory (the)	IO	GET /IO.svg
Brunei Darussalam	BN	GET /BN.svg
Bulgaria	BG	GET /BG.svg
Burkina Faso	BF	GET /BF.svg
Burundi	BI	GET /BI.svg
Cabo Verde	CV	GET /CV.svg
Cambodia	KH	GET /KH.svg
Cameroon	CM	GET /CM.svg
Canada	CA	GET /CA.svg
Cayman Islands (the)	KY	GET /KY.svg
Central African Republic (the)	CF	GET /CF.svg
Chad	TD	GET /TD.svg
Chile	CL	GET /CL.svg
China	CN	GET /CN.svg
Christmas Island	CX	GET /CX.svg
Cocos (Keeling) Islands (the)	CC	GET /CC.svg
Colombia	CO	GET /CO.svg
Comoros (the)	KM	GET /KM.svg
Congo (the Democratic Republic of the)	CD	GET /CD.svg
Congo (the)	CG	GET /CG.svg
Cook Islands (the)	CK	GET /CK.svg
Costa Rica	CR	GET /CR.svg
Croatia	HR	GET /HR.svg
Cuba	CU	GET /CU.svg
Curaçao	CW	GET /CW.svg
Cyprus	CY	GET /CY.svg
Czechia	CZ	GET /CZ.svg
Côte d'Ivoire	CI	GET /CI.svg
Denmark	DK	GET /DK.svg
Djibouti	DJ	GET /DJ.svg
Dominica	DM	GET /DM.svg
Dominican Republic (the)	DO	GET /DO.svg
Ecuador	EC	GET /EC.svg
Egypt	EG	GET /EG.svg
El Salvador	SV	GET /SV.svg
Equatorial Guinea	GQ	GET /GQ.svg
Eritrea	ER	GET /ER.svg
Estonia	EE	GET /EE.svg
Eswatini	SZ	GET /SZ.svg
Ethiopia	ET	GET /ET.svg
Falkland Islands (the) [Malvinas]	FK	GET /FK.svg
Faroe Islands (the)	FO	GET /FO.svg
Fiji	FJ	GET /FJ.svg
Finland	FI	GET /FI.svg
France	FR	GET /FR.svg
French Guiana	GF	GET /GF.svg
French Polynesia	PF	GET /PF.svg
French Southern Territories (the)	TF	GET /TF.svg
Gabon	GA	GET /GA.svg
Gambia (the)	GM	GET /GM.svg
Georgia	GE	GET /GE.svg
Germany	DE	GET /DE.svg
Ghana	GH	GET /GH.svg
Gibraltar	GI	GET /GI.svg
Greece	GR	GET /GR.svg
Greenland	GL	GET /GL.svg
Grenada	GD	GET /GD.svg
Guadeloupe	GP	GET /GP.svg
Guam	GU	GET /GU.svg
Guatemala	GT	GET /GT.svg
Guernsey	GG	GET /GG.svg
Guinea	GN	GET /GN.svg
Guinea-Bissau	GW	GET /GW.svg
Guyana	GY	GET /GY.svg
Haiti	HT	GET /HT.svg
Heard Island and McDonald Islands	HM	GET /HM.svg
Holy See (the)	VA	GET /VA.svg
Honduras	HN	GET /HN.svg
Hong Kong	HK	GET /HK.svg
Hungary	HU	GET /HU.svg
Iceland	IS	GET /IS.svg
India	IN	GET /IN.svg
Indonesia	ID	GET /ID.svg
Iran (Islamic Republic of)	IR	GET /IR.svg
Iraq	IQ	GET /IQ.svg
Ireland	IE	GET /IE.svg
Isle of Man	IM	GET /IM.svg
Israel	IL	GET /IL.svg
Italy	IT	GET /IT.svg
Jamaica	JM	GET /JM.svg
Japan	JP	GET /JP.svg
Jersey	JE	GET /JE.svg
Jordan	JO	GET /JO.svg
Kazakhstan	KZ	GET /KZ.svg
Kenya	KE	GET /KE.svg
Kiribati	KI	GET /KI.svg
Korea (the Democratic People's Republic of)	KP	GET /KP.svg
Korea (the Republic of)	KR	GET /KR.svg
Kuwait	KW	GET /KW.svg
Kyrgyzstan	KG	GET /KG.svg
Lao People's Democratic Republic (the)	LA	GET /LA.svg
Latvia	LV	GET /LV.svg
Lebanon	LB	GET /LB.svg
Lesotho	LS	GET /LS.svg
Liberia	LR	GET /LR.svg
Libya	LY	GET /LY.svg
Liechtenstein	LI	GET /LI.svg
Lithuania	LT	GET /LT.svg
Luxembourg	LU	GET /LU.svg
Macao	MO	GET /MO.svg
Madagascar	MG	GET /MG.svg
Malawi	MW	GET /MW.svg
Malaysia	MY	GET /MY.svg
Maldives	MV	GET /MV.svg
Mali	ML	GET /ML.svg
Malta	MT	GET /MT.svg
Marshall Islands (the)	MH	GET /MH.svg
Martinique	MQ	GET /MQ.svg
Mauritania	MR	GET /MR.svg
Mauritius	MU	GET /MU.svg
Mayotte	YT	GET /YT.svg
Mexico	MX	GET /MX.svg
Micronesia (Federated States of)	FM	GET /FM.svg
Moldova (the Republic of)	MD	GET /MD.svg
Monaco	MC	GET /MC.svg
Mongolia	MN	GET /MN.svg
Montenegro	ME	GET /ME.svg
Montserrat	MS	GET /MS.svg
Morocco	MA	GET /MA.svg
Mozambique	MZ	GET /MZ.svg
Myanmar	MM	GET /MM.svg
Namibia	NA	GET /NA.svg
Nauru	NR	GET /NR.svg
Nepal	NP	GET /NP.svg
Netherlands (the)	NL	GET /NL.svg
New Caledonia	NC	GET /NC.svg
New Zealand	NZ	GET /NZ.svg
Nicaragua	NI	GET /NI.svg
Niger (the)	NE	GET /NE.svg
Nigeria	NG	GET /NG.svg
Niue	NU	GET /NU.svg
Norfolk Island	NF	GET /NF.svg
Northern Mariana Islands (the)	MP	GET /MP.svg
Norway	NO	GET /NO.svg
Oman	OM	GET /OM.svg
Pakistan	PK	GET /PK.svg
Palau	PW	GET /PW.svg
Palestine, State of	PS	GET /PS.svg
Panama	PA	GET /PA.svg
Papua New Guinea	PG	GET /PG.svg
Paraguay	PY	GET /PY.svg
Peru	PE	GET /PE.svg
Philippines (the)	PH	GET /PH.svg
Pitcairn	PN	GET /PN.svg
Poland	PL	GET /PL.svg
Portugal	PT	GET /PT.svg
Puerto Rico	PR	GET /PR.svg
Qatar	QA	GET /QA.svg
Republic of North Macedonia	MK	GET /MK.svg
Romania	RO	GET /RO.svg
Russian Federation (the)	RU	GET /RU.svg
Rwanda	RW	GET /RW.svg
Réunion	RE	GET /RE.svg
Saint Barthélemy	BL	GET /BL.svg
Saint Helena, Ascension and Tristan da Cunha	SH	GET /SH.svg
Saint Kitts and Nevis	KN	GET /KN.svg
Saint Lucia	LC	GET /LC.svg
Saint Martin (French part)	MF	GET /MF.svg
Saint Pierre and Miquelon	PM	GET /PM.svg
Saint Vincent and the Grenadines	VC	GET /VC.svg
Samoa	WS	GET /WS.svg
San Marino	SM	GET /SM.svg
Sao Tome and Principe	ST	GET /ST.svg
Saudi Arabia	SA	GET /SA.svg
Senegal	SN	GET /SN.svg
Serbia	RS	GET /RS.svg
Seychelles	SC	GET /SC.svg
Sierra Leone	SL	GET /SL.svg
Singapore	SG	GET /SG.svg
Sint Maarten (Dutch part)	SX	GET /SX.svg
Slovakia	SK	GET /SK.svg
Slovenia	SI	GET /SI.svg
Solomon Islands	SB	GET /SB.svg
Somalia	SO	GET /SO.svg
South Africa	ZA	GET /ZA.svg
South Georgia and the South Sandwich Islands	GS	GET /GS.svg
South Sudan	SS	GET /SS.svg
Spain	ES	GET /ES.svg
Sri Lanka	LK	GET /LK.svg
Sudan (the)	SD	GET /SD.svg
Suriname	SR	GET /SR.svg
Svalbard and Jan Mayen	SJ	GET /SJ.svg
Sweden	SE	GET /SE.svg
Switzerland	CH	GET /CH.svg
Syrian Arab Republic	SY	GET /SY.svg
Taiwan (Province of China)	TW	GET /TW.svg
Tajikistan	TJ	GET /TJ.svg
Tanzania, United Republic of	TZ	GET /TZ.svg
Thailand	TH	GET /TH.svg
Timor-Leste	TL	GET /TL.svg
Togo	TG	GET /TG.svg
Tokelau	TK	GET /TK.svg
Tonga	TO	GET /TO.svg
Trinidad and Tobago	TT	GET /TT.svg
Tunisia	TN	GET /TN.svg
Turkey	TR	GET /TR.svg
Turkmenistan	TM	GET /TM.svg
Turks and Caicos Islands (the)	TC	GET /TC.svg
Tuvalu	TV	GET /TV.svg
Uganda	UG	GET /UG.svg
Ukraine	UA	GET /UA.svg
United Arab Emirates (the)	AE	GET /AE.svg
United Kingdom of Great Britain and Northern Ireland (the)	GB	GET /GB.svg
United States Minor Outlying Islands (the)	UM	GET /UM.svg
United States of America (the)	US	GET /US.svg
Uruguay	UY	GET /UY.svg
Uzbekistan	UZ	GET /UZ.svg
Vanuatu	VU	GET /VU.svg
Venezuela (Bolivarian Republic of)	VE	GET /VE.svg
Viet Nam	VN	GET /VN.svg
Virgin Islands (British)	VG	GET /VG.svg
Virgin Islands (U.S.)	VI	GET /VI.svg
Wallis and Futuna	WF	GET /WF.svg
Western Sahara	EH	GET /EH.svg
Yemen	YE	GET /YE.svg
Zambia	ZM	GET /ZM.svg
Zimbabwe	ZW	GET /ZW.svg
Åland Islands	AX	GET /AX.svg

Showing 249 official ISO country codes

help Got Questions?

Frequently Asked Questions

Everything you need to know about the product, uptime, and usage terms.

Are endpoint country codes case-sensitive? expand_more

Yes. Endpoint country codes must be provided in lowercase format (e.g., `us`, `ca`). Uppercase or mixed-case codes are not supported and will result in a 404 response.

Is Alfian Flag API completely free and unlimited to use? expand_more

Yes! Alfian Flag API is 100% free with unlimited requests and zero throttling, making it fully accessible for personal projects, portfolios, production apps, and MVPs without hidden costs.

What image formats and file types are supported? expand_more

We exclusively support scalable vector graphics (SVG) for pristine rendering at any screen density. Raster image formats such as PNG or WebP are not supported.

How often is the country code database updated? expand_more

Our database is synced automatically with standard ISO 3166-1 registries and updated immediately whenever there are official alterations to country flags, regional designations, or territory codes.