Flagswing for Developers
Embed any flag in seconds. CDN, API, React package, and Figma plugin — free tier available, no signup required for CDN.
CDN — Zero Config
Drop any flag into your HTML with a single <img> tag. No API key required.
<!-- Flagswing CDN — no signup required -->
<img
src="https://pub-d7a1861fd19b400ab91b028d5ffa0d27.r2.dev/flags/svg/uz.svg"
alt="UZ flag"
width="32"
height="24"
loading="lazy"
/>Live Preview
CDN URL format
https://pub-d7a1861fd19b400ab91b028d5ffa0d27.r2.dev/flags/svg/{code}.svgReplace svg with png or eps for other formats.
REST API
Fetch flag metadata, formats, and colors from our JSON API.
https://api.flagswing.com/v1/flags/{code}Single flag by ISO codehttps://api.flagswing.com/v1/flags/{code}?format=pngSingle flag, specific formathttps://api.flagswing.com/v1/flags?region=europe&limit=20List flags by regionhttps://api.flagswing.com/v1/flags/search?q=uzbSearch flags by name or codeExample Response
{
"code": "uz",
"name": "Uzbekistan",
"slug": "uzbekistan",
"formats": {
"svg": "https://pub-d7a1861fd19b400ab91b028d5ffa0d27.r2.dev/flags/svg/uz.svg",
"png": "https://pub-d7a1861fd19b400ab91b028d5ffa0d27.r2.dev/flags/png/uz.png",
"eps": "https://pub-d7a1861fd19b400ab91b028d5ffa0d27.r2.dev/flags/eps/uz.eps"
},
"colors": [
{ "name": "Teal Blue", "hex": "#1EBFAE" },
{ "name": "White", "hex": "#FFFFFF" },
{ "name": "Green", "hex": "#1EB53A" }
],
"license": "free",
"premium_shapes": ["sphere", "heart", "star", "wave"]
}Rate Limits
| Plan | Requests / day | Price |
|---|---|---|
| Free | 100 | $0 |
| Basic | 1,000 | $9/mo |
| Pro | 10,000 | $29/mo |
| Enterprise | Unlimited | Contact |
React Package
Coming SoonInstall the official flagswing-react package and render flags with a single component.
npm install flagswing-react
import { Flag, FlagIcon } from 'flagswing-react'
// Basic rectangular flag
<Flag country="uz" size={32} />
// Premium shape — sphere
<Flag country="uz" shape="sphere" size={64} />
// Compact icon variant
<FlagIcon country="us" />Join the waitlist
Be the first to know when flagswing-react launches.
Figma Plugin
Coming SoonSearch and insert any flag directly inside Figma — no copy-paste, no file management.
- Search 250+ flags directly in Figma
- Insert as SVG or PNG
- Premium shapes for Pro users
- Auto-update when flags change
Get notified at launch
We'll email you the moment the plugin goes live on Figma Community.
Open Source Ecosystem
We stand on the shoulders of great open-source work. All repos below are MIT licensed and included in our free tier.
400+ minimalist circular SVG flags, pixel-perfect at any size.
CSS class–based flag library with 250+ country flags.
React components for country flags — part of the flagpack ecosystem.
Ready to embed flags?
CDN is free forever — no account needed. API key unlocks higher limits and metadata.