{"openapi":"3.1.0","info":{"title":"Flags API","version":"1.0.0","description":"National flag design as an API — built on the classic UCI \"Flags\" dataset (194 countries) and enriched with each country's ISO 3166-1 alpha-2 code, its Unicode flag emoji and ready-to-use SVG / PNG image URLs. For each flag the API exposes its real design attributes: the number of vertical bars and horizontal stripes, the colours present, the predominant (\"main\") hue, the colours of the top-left and bottom-right corners, and which symbols appear — circles, crosses, saltires, quartered fields, stars or suns, a crescent, a triangle, an inanimate icon (e.g. an anchor), an animate image (e.g. an eagle) or written text. Look a flag up by country or code, search, or FILTER flags by colour, main hue or symbol — \"every flag with a crescent\", \"flags that are mainly green\". Served from memory — always fast.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/flags-api","description":"oanor gateway"}],"tags":[{"name":"Lookup"},{"name":"Search"},{"name":"Filter"},{"name":"List"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/flag":{"get":{"operationId":"get_v1_flag","tags":["Lookup"],"summary":"Flag by country or code","description":"","parameters":[{"name":"country","in":"query","required":false,"description":"Country name","schema":{"type":"string"},"example":"Germany"},{"name":"code","in":"query","required":false,"description":"ISO 3166-1 alpha-2 code","schema":{"type":"string"},"example":"de"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"flag":{"code":"DE","emoji":"🇩🇪","country":"Germany FRG","image_png":"https://flagcdn.com/w320/de.png","image_svg":"https://flagcdn.com/de.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","gold","black"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"black","stripes":3,"topleft":"black","botright":"gold","crescent":false,"quarters":0,"saltires":0,"triangle":false}}},"meta":{"timestamp":"2026-06-08T18:25:10.023Z","request_id":"03c7c2ed-902f-4aca-8a63-1bca8936ff78"},"status":"ok","message":"Flag retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search flags by country","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query (min 2 chars)","schema":{"type":"string"},"example":"united"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":0,"flags":[],"query":"united","total":0},"meta":{"timestamp":"2026-06-08T18:25:10.115Z","request_id":"002e871a-edc3-44df-ab46-dde2f60a2333"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/filter":{"get":{"operationId":"get_v1_filter","tags":["Filter"],"summary":"Filter flags by colour, hue or symbol","description":"","parameters":[{"name":"color","in":"query","required":false,"description":"A colour present on the flag","schema":{"type":"string"},"example":"green"},{"name":"mainhue","in":"query","required":false,"description":"Predominant hue","schema":{"type":"string"},"example":"green"},{"name":"symbol","in":"query","required":false,"description":"crescent, star, cross, saltire, circle, triangle, quarter, text, icon, animate","schema":{"type":"string"},"example":"crescent"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":4,"flags":[{"code":"DZ","emoji":"🇩🇿","country":"Algeria","image_png":"https://flagcdn.com/w320/dz.png","image_svg":"https://flagcdn.com/dz.svg","attributes":{"bars":2,"icon":false,"text":false,"stars":1,"colors":["red","green","white"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"white","crescent":true,"quarters":0,"saltires":0,"triangle":false}},{"country":"Comorro Islands","attributes":{"bars":0,"icon":false,"text":false,"stars":4,"colors":["green","white"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"green","crescent":true,"quarters":0,"saltires":0,"triangle":false}},{"code":"MR","emoji":"🇲🇷","country":"Mauritania","image_png":"https://flagcdn.com/w320/mr.png","image_svg":"https://flagcdn.com/mr.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["green","gold"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"green","crescent":true,"quarters":0,"saltires":0,"triangle":false}},{"code":"PK","emoji":"🇵🇰","country":"Pakistan","image_png":"https://flagcdn.com/w320/pk.png","image_svg":"https://flagcdn.com/pk.svg","attributes":{"bars":1,"icon":false,"text":false,"stars":1,"colors":["green","white"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"green","stripes":0,"topleft":"white","botright":"green","crescent":true,"quarters":0,"saltires":0,"triangle":false}}],"total":4,"filter":{"color":"green","symbol":"crescent","mainhue":"green"}},"meta":{"timestamp":"2026-06-08T18:25:10.224Z","request_id":"5e47c26d-27f7-496b-a72a-8a461c6e11f8"},"status":"ok","message":"Filtered flags retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["List"],"summary":"List all flags","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-300)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"flags":[{"code":"AF","emoji":"🇦🇫","country":"Afghanistan","image_png":"https://flagcdn.com/w320/af.png","image_svg":"https://flagcdn.com/af.svg","attributes":{"bars":0,"icon":true,"text":false,"stars":1,"colors":["red","green","gold","white","black"],"animate":false,"circles":0,"colours":5,"crosses":0,"mainhue":"green","stripes":3,"topleft":"black","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"AL","emoji":"🇦🇱","country":"Albania","image_png":"https://flagcdn.com/w320/al.png","image_svg":"https://flagcdn.com/al.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["red","gold","black"],"animate":true,"circles":0,"colours":3,"crosses":0,"mainhue":"red","stripes":0,"topleft":"red","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"DZ","emoji":"🇩🇿","country":"Algeria","image_png":"https://flagcdn.com/w320/dz.png","image_svg":"https://flagcdn.com/dz.svg","attributes":{"bars":2,"icon":false,"text":false,"stars":1,"colors":["red","green","white"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"white","crescent":true,"quarters":0,"saltires":0,"triangle":false}},{"code":"AS","emoji":"🇦🇸","country":"American Samoa","image_png":"https://flagcdn.com/w320/as.png","image_svg":"https://flagcdn.com/as.svg","attributes":{"bars":0,"icon":true,"text":false,"stars":0,"colors":["red","blue","gold","white","orange"],"animate":true,"circles":0,"colours":5,"crosses":0,"mainhue":"blue","stripes":0,"topleft":"blue","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":true}},{"code":"AD","emoji":"🇦🇩","country":"Andorra","image_png":"https://flagcdn.com/w320/ad.png","image_svg":"https://flagcdn.com/ad.svg","attributes":{"bars":3,"icon":false,"text":false,"stars":0,"colors":["red","blue","gold"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"gold","stripes":0,"topleft":"blue","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"AO","emoji":"🇦🇴","country":"Angola","image_png":"https://flagcdn.com/w320/ao.png","image_svg":"https://flagcdn.com/ao.svg","attributes":{"bars":0,"icon":true,"text":false,"stars":1,"colors":["red","gold","black"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"red","stripes":2,"topleft":"red","botright":"black","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"AI","emoji":"🇦🇮","country":"Anguilla","image_png":"https://flagcdn.com/w320/ai.png","image_svg":"https://flagcdn.com/ai.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["blue","white","orange"],"animate":true,"circles":0,"colours":3,"crosses":0,"mainhue":"white","stripes":1,"topleft":"white","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"AG","emoji":"🇦🇬","country":"Antigua Barbuda","image_png":"https://flagcdn.com/w320/ag.png","image_svg":"https://flagcdn.com/ag.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["red","blue","gold","white","black"],"animate":false,"circles":0,"colours":5,"crosses":0,"mainhue":"red","stripes":1,"topleft":"black","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":true}},{"code":"AR","emoji":"🇦🇷","country":"Argentina","image_png":"https://flagcdn.com/w320/ar.png","image_svg":"https://flagcdn.com/ar.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["blue","white"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"blue","stripes":3,"topleft":"blue","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"country":"Argentine","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["blue","gold","white"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"blue","stripes":3,"topleft":"blue","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"AU","emoji":"🇦🇺","country":"Australia","image_png":"https://flagcdn.com/w320/au.png","image_svg":"https://flagcdn.com/au.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":6,"colors":["red","blue","white"],"animate":false,"circles":0,"colours":3,"crosses":1,"mainhue":"blue","stripes":0,"topleft":"white","botright":"blue","crescent":false,"quarters":1,"saltires":1,"triangle":false}},{"code":"AT","emoji":"🇦🇹","country":"Austria","image_png":"https://flagcdn.com/w320/at.png","image_svg":"https://flagcdn.com/at.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","white"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"red","stripes":3,"topleft":"red","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BS","emoji":"🇧🇸","country":"Bahamas","image_png":"https://flagcdn.com/w320/bs.png","image_svg":"https://flagcdn.com/bs.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["blue","gold","black"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"blue","stripes":3,"topleft":"blue","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":true}},{"code":"BH","emoji":"🇧🇭","country":"Bahrain","image_png":"https://flagcdn.com/w320/bh.png","image_svg":"https://flagcdn.com/bh.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","white"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"red","stripes":0,"topleft":"white","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BD","emoji":"🇧🇩","country":"Bangladesh","image_png":"https://flagcdn.com/w320/bd.png","image_svg":"https://flagcdn.com/bd.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","green"],"animate":false,"circles":1,"colours":2,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BB","emoji":"🇧🇧","country":"Barbados","image_png":"https://flagcdn.com/w320/bb.png","image_svg":"https://flagcdn.com/bb.svg","attributes":{"bars":3,"icon":true,"text":false,"stars":0,"colors":["blue","gold","black"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"blue","stripes":0,"topleft":"blue","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BE","emoji":"🇧🇪","country":"Belgium","image_png":"https://flagcdn.com/w320/be.png","image_svg":"https://flagcdn.com/be.svg","attributes":{"bars":3,"icon":false,"text":false,"stars":0,"colors":["red","gold","black"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"gold","stripes":0,"topleft":"black","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BZ","emoji":"🇧🇿","country":"Belize","image_png":"https://flagcdn.com/w320/bz.png","image_svg":"https://flagcdn.com/bz.svg","attributes":{"bars":0,"icon":true,"text":true,"stars":0,"colors":["red","green","blue","gold","white","black","orange"],"animate":true,"circles":1,"colours":8,"crosses":0,"mainhue":"blue","stripes":2,"topleft":"red","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BJ","emoji":"🇧🇯","country":"Benin","image_png":"https://flagcdn.com/w320/bj.png","image_svg":"https://flagcdn.com/bj.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["red","green"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BM","emoji":"🇧🇲","country":"Bermuda","image_png":"https://flagcdn.com/w320/bm.png","image_svg":"https://flagcdn.com/bm.svg","attributes":{"bars":0,"icon":true,"text":false,"stars":0,"colors":["red","green","blue","gold","white","black"],"animate":true,"circles":1,"colours":6,"crosses":1,"mainhue":"red","stripes":0,"topleft":"white","botright":"red","crescent":false,"quarters":1,"saltires":1,"triangle":false}},{"code":"BT","emoji":"🇧🇹","country":"Bhutan","image_png":"https://flagcdn.com/w320/bt.png","image_svg":"https://flagcdn.com/bt.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","white","black","orange"],"animate":true,"circles":4,"colours":4,"crosses":0,"mainhue":"orange","stripes":0,"topleft":"orange","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BO","emoji":"🇧🇴","country":"Bolivia","image_png":"https://flagcdn.com/w320/bo.png","image_svg":"https://flagcdn.com/bo.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","green","gold"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"red","stripes":3,"topleft":"red","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BW","emoji":"🇧🇼","country":"Botswana","image_png":"https://flagcdn.com/w320/bw.png","image_svg":"https://flagcdn.com/bw.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["blue","white","black"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"blue","stripes":5,"topleft":"blue","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"BR","emoji":"🇧🇷","country":"Brazil","image_png":"https://flagcdn.com/w320/br.png","image_svg":"https://flagcdn.com/br.svg","attributes":{"bars":0,"icon":false,"text":true,"stars":22,"colors":["green","blue","gold","white"],"animate":false,"circles":1,"colours":4,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"country":"British Virgin Isles","attributes":{"bars":0,"icon":true,"text":true,"stars":0,"colors":["red","green","blue","gold","white","orange"],"animate":true,"circles":0,"colours":6,"crosses":1,"mainhue":"blue","stripes":0,"topleft":"white","botright":"blue","crescent":false,"quarters":1,"saltires":1,"triangle":false}},{"code":"BN","emoji":"🇧🇳","country":"Brunei","image_png":"https://flagcdn.com/w320/bn.png","image_svg":"https://flagcdn.com/bn.svg","attributes":{"bars":0,"icon":true,"text":true,"stars":0,"colors":["red","gold","white","black"],"animate":true,"circles":0,"colours":4,"crosses":0,"mainhue":"gold","stripes":0,"topleft":"white","botright":"gold","crescent":false,"quarters":0,"saltires":0,"triangle":true}},{"code":"BG","emoji":"🇧🇬","country":"Bulgaria","image_png":"https://flagcdn.com/w320/bg.png","image_svg":"https://flagcdn.com/bg.svg","attributes":{"bars":0,"icon":true,"text":false,"stars":1,"colors":["red","green","blue","gold","white"],"animate":true,"circles":0,"colours":5,"crosses":0,"mainhue":"red","stripes":3,"topleft":"white","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"country":"Burkina","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["red","green","gold"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"red","stripes":2,"topleft":"red","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"MM","emoji":"🇲🇲","country":"Burma","image_png":"https://flagcdn.com/w320/mm.png","image_svg":"https://flagcdn.com/mm.svg","attributes":{"bars":0,"icon":true,"text":false,"stars":14,"colors":["red","blue","white"],"animate":true,"circles":0,"colours":3,"crosses":0,"mainhue":"red","stripes":0,"topleft":"blue","botright":"red","crescent":false,"quarters":1,"saltires":0,"triangle":false}},{"code":"BI","emoji":"🇧🇮","country":"Burundi","image_png":"https://flagcdn.com/w320/bi.png","image_svg":"https://flagcdn.com/bi.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":3,"colors":["red","green","white"],"animate":false,"circles":1,"colours":3,"crosses":0,"mainhue":"red","stripes":0,"topleft":"white","botright":"white","crescent":false,"quarters":0,"saltires":1,"triangle":false}},{"code":"CM","emoji":"🇨🇲","country":"Cameroon","image_png":"https://flagcdn.com/w320/cm.png","image_svg":"https://flagcdn.com/cm.svg","attributes":{"bars":3,"icon":false,"text":false,"stars":1,"colors":["red","green","gold"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"gold","stripes":0,"topleft":"green","botright":"gold","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"CA","emoji":"🇨🇦","country":"Canada","image_png":"https://flagcdn.com/w320/ca.png","image_svg":"https://flagcdn.com/ca.svg","attributes":{"bars":2,"icon":false,"text":false,"stars":0,"colors":["red","white"],"animate":true,"circles":0,"colours":2,"crosses":0,"mainhue":"red","stripes":0,"topleft":"red","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"country":"Cape Verde Islands","attributes":{"bars":1,"icon":false,"text":false,"stars":1,"colors":["red","green","gold","black","orange"],"animate":true,"circles":0,"colours":5,"crosses":0,"mainhue":"gold","stripes":2,"topleft":"red","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"KY","emoji":"🇰🇾","country":"Cayman Islands","image_png":"https://flagcdn.com/w320/ky.png","image_svg":"https://flagcdn.com/ky.svg","attributes":{"bars":0,"icon":true,"text":true,"stars":4,"colors":["red","green","blue","gold","white","orange"],"animate":true,"circles":1,"colours":6,"crosses":1,"mainhue":"blue","stripes":0,"topleft":"white","botright":"blue","crescent":false,"quarters":1,"saltires":1,"triangle":false}},{"code":"CF","emoji":"🇨🇫","country":"Central African Republic","image_png":"https://flagcdn.com/w320/cf.png","image_svg":"https://flagcdn.com/cf.svg","attributes":{"bars":1,"icon":false,"text":false,"stars":1,"colors":["red","green","blue","gold","white"],"animate":false,"circles":0,"colours":5,"crosses":0,"mainhue":"gold","stripes":0,"topleft":"blue","botright":"gold","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"TD","emoji":"🇹🇩","country":"Chad","image_png":"https://flagcdn.com/w320/td.png","image_svg":"https://flagcdn.com/td.svg","attributes":{"bars":3,"icon":false,"text":false,"stars":0,"colors":["red","blue","gold"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"gold","stripes":0,"topleft":"blue","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"CL","emoji":"🇨🇱","country":"Chile","image_png":"https://flagcdn.com/w320/cl.png","image_svg":"https://flagcdn.com/cl.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["red","blue","white"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"red","stripes":2,"topleft":"blue","botright":"red","crescent":false,"quarters":1,"saltires":0,"triangle":false}},{"code":"CN","emoji":"🇨🇳","country":"China","image_png":"https://flagcdn.com/w320/cn.png","image_svg":"https://flagcdn.com/cn.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":5,"colors":["red","gold"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"red","stripes":0,"topleft":"red","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"CO","emoji":"🇨🇴","country":"Colombia","image_png":"https://flagcdn.com/w320/co.png","image_svg":"https://flagcdn.com/co.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","blue","gold"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"gold","stripes":3,"topleft":"gold","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"country":"Comorro Islands","attributes":{"bars":0,"icon":false,"text":false,"stars":4,"colors":["green","white"],"animate":false,"circles":0,"colours":2,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"green","crescent":true,"quarters":0,"saltires":0,"triangle":false}},{"code":"CG","emoji":"🇨🇬","country":"Congo","image_png":"https://flagcdn.com/w320/cg.png","image_svg":"https://flagcdn.com/cg.svg","attributes":{"bars":0,"icon":true,"text":false,"stars":1,"colors":["red","green","gold"],"animate":true,"circles":0,"colours":3,"crosses":0,"mainhue":"red","stripes":0,"topleft":"red","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"CK","emoji":"🇨🇰","country":"Cook Islands","image_png":"https://flagcdn.com/w320/ck.png","image_svg":"https://flagcdn.com/ck.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":15,"colors":["red","blue","white"],"animate":false,"circles":1,"colours":4,"crosses":1,"mainhue":"blue","stripes":0,"topleft":"white","botright":"blue","crescent":false,"quarters":1,"saltires":1,"triangle":false}},{"code":"CR","emoji":"🇨🇷","country":"Costa Rica","image_png":"https://flagcdn.com/w320/cr.png","image_svg":"https://flagcdn.com/cr.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","blue","white"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"blue","stripes":5,"topleft":"blue","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"CU","emoji":"🇨🇺","country":"Cuba","image_png":"https://flagcdn.com/w320/cu.png","image_svg":"https://flagcdn.com/cu.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["red","blue","white"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"blue","stripes":5,"topleft":"blue","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":true}},{"code":"CY","emoji":"🇨🇾","country":"Cyprus","image_png":"https://flagcdn.com/w320/cy.png","image_svg":"https://flagcdn.com/cy.svg","attributes":{"bars":0,"icon":true,"text":false,"stars":0,"colors":["green","gold","white"],"animate":true,"circles":0,"colours":3,"crosses":0,"mainhue":"white","stripes":0,"topleft":"white","botright":"white","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"country":"Czechoslovakia","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","blue","white"],"animate":false,"circles":0,"colours":3,"crosses":0,"mainhue":"white","stripes":0,"topleft":"white","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":true}},{"code":"DK","emoji":"🇩🇰","country":"Denmark","image_png":"https://flagcdn.com/w320/dk.png","image_svg":"https://flagcdn.com/dk.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","white"],"animate":false,"circles":0,"colours":2,"crosses":1,"mainhue":"red","stripes":0,"topleft":"red","botright":"red","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"DJ","emoji":"🇩🇯","country":"Djibouti","image_png":"https://flagcdn.com/w320/dj.png","image_svg":"https://flagcdn.com/dj.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":1,"colors":["red","green","blue","white"],"animate":false,"circles":0,"colours":4,"crosses":0,"mainhue":"blue","stripes":0,"topleft":"white","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":true}},{"code":"DM","emoji":"🇩🇲","country":"Dominica","image_png":"https://flagcdn.com/w320/dm.png","image_svg":"https://flagcdn.com/dm.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":10,"colors":["red","green","blue","gold","white","black"],"animate":true,"circles":1,"colours":6,"crosses":0,"mainhue":"green","stripes":0,"topleft":"green","botright":"green","crescent":false,"quarters":0,"saltires":0,"triangle":false}},{"code":"DO","emoji":"🇩🇴","country":"Dominican Republic","image_png":"https://flagcdn.com/w320/do.png","image_svg":"https://flagcdn.com/do.svg","attributes":{"bars":0,"icon":false,"text":false,"stars":0,"colors":["red","blue","white"],"animate":false,"circles":0,"colours":3,"crosses":1,"mainhue":"blue","stripes":0,"topleft":"blue","botright":"blue","crescent":false,"quarters":0,"saltires":0,"triangle":false}}],"total":194},"meta":{"timestamp":"2026-06-08T18:25:10.344Z","request_id":"8b7d2cc7-e58c-4042-8f71-5b985407e916"},"status":"ok","message":"Flags listed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"flags-api","endpoints":{"GET /v1/flag":"Flag by country (country=, e.g. Germany) or ISO code (code=, e.g. de).","GET /v1/list":"List all flags (limit, offset).","GET /v1/meta":"This document.","GET /v1/filter":"Filter flags by color=, mainhue= or symbol= (crescent, star, cross, saltire, circle, triangle, quarter, text, icon, animate).","GET /v1/search":"Search flags by country name or code (q=, min 2 chars)."},"description":"National flag design (UCI Flags dataset, 194 countries) enriched with ISO 3166-1 alpha-2 code, Unicode flag emoji and SVG/PNG image URLs. Exposes each flag's bars, stripes, colours, main hue, corner colours and symbols (stars, crescent, cross, saltire, circle, triangle, icon, animate, text). Look up by country or code, search, or filter by colour / main hue / symbol. No key.","total_flags":194},"meta":{"timestamp":"2026-06-08T18:25:10.442Z","request_id":"50d599f6-c2de-45e2-bb84-9e3e5076e73d"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":25000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":250000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1200,"monthly_call_quota":1200000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3000,"monthly_call_quota":6000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/flags-api"}