Open Flags Docs

Appearance

Availible Routes / cURL ​

There are several enpoints that you can get flag data from The basic breakdown of routes and their returns is as follows;

Info by ISO 3166 ​

will return JSON of availible flagInfo based on country/region search

cli
    GET https://api.openflags.net/v1/api/json/ISO3166/:regionCode

Info by Region ​

will return JSON of availible flagInfo based on country/region search

cli
 GET https://api.openflags.net/v1/api/json/flagInfo/:country/:region

Image by Region ​

will return a direct link to the .svg flag at that country/region

cli
 GET https://api.openflags.net/v1/:country/:region/:region.svg

Info by Country ​

will return an array of JSON objects of all flags from the :country on the Open Flags API

cli
 GET https://api.openflags.net/v1/api/list/country/:country

will return a string of a direct link to a random flag .svg

cli
  GET https://api.openflags.net/v1/rando

Random image ​

will return a the image of a random flag .svg from all flags availible

cli
  GET https://api.openflags.net/v1/rando-path

All ​

will return an array of JSON objects of all flags availible on the Open Flags API

cli
 GET https://api.openflags.net/v1/api/list/country/:country