Flag Assets Library

What's Included

World Flags

271 flags

• All UN member states
• Territories and dependencies
• Regional flags (England, Scotland, Wales, etc.)
• International organizations (EU, UN, ASEAN)

US State Flags

56 flags

• All 50 US states
• District of Columbia
• 5 US territories (PR, GU, VI, AS, MP)

Available Formats

Each flag is available in 6 formats to suit any use case:

All PNG files have transparent backgrounds with flags proportionally scaled and centered.

Usage

URL Pattern

HTML Example

<!-- World flag (Germany) -->
<img src="https://flags.telco.dev/world/de/de_240x160.png" alt="Germany">

<!-- US state flag (California) -->
<img src="https://flags.telco.dev/us/ca/ca_240x160.png" alt="California">

Fetch Metadata

Each flag includes a JSON file with metadata and all URLs:

const response = await fetch('https://flags.telco.dev/world/jp/jp.json');
const flag = await response.json();

console.log(flag.name);         // "Japan"
console.log(flag.abbreviation); // "JP"
console.log(flag.files.svg);    // Full SVG URL

Used in Our API

These flags are automatically included in our Phone Number Format API. When you look up a phone number, you get country and state flag URLs in the response:

{
  "country": "US",
  "location": {
    "state": "FL",
    "stateName": "Florida"
  },
  "flags": {
    "country": {
      "name": "United States",
      "svg": "https://flags.telco.dev/world/us/us.svg",
      "png": {
        "small": "https://flags.telco.dev/world/us/us_48x32.png",
        "medium": "https://flags.telco.dev/world/us/us_240x160.png"
      }
    },
    "state": {
      "name": "Florida",
      "svg": "https://flags.telco.dev/us/fl/fl.svg",
      "png": { ... }
    }
  }
}

GitHub Repository

The complete flag library is available on GitHub. Browse the source, download individual flags, or contribute corrections: