---
title: Supported Flags API Reference
version: 1.0.0
description: "Retrieve the list of all country and international organization flags supported by the Flags API. Returns two arrays: `supported_countries` (238 entries) with country names and ISO codes for every available country flag, and `supported_organizations` (22 entries) with case-sensitive identifiers for international organization flags (e.g., United_Nations, NATO, European_Union). Use the returned identifiers with the Flags API's name parameter to retrieve actual flag images — organization identifiers must be passed exactly as listed here, including underscores and capitalization. This endpoint takes no required parameters and has no documented error responses."
openapi: 3.1.1
servers:
  - https://api.apifreaks.com/v1.0
paths: 1
operations: 1
schemas: 2
---

## Table of Contents

- [Supported Flags API Reference v1.0.0](#supported-flags-api-reference-v100)
  - [Authentication](#authentication)
  - [Flags APIs](#flags-apis)
    - [getSupportedFlags](#getsupportedflags)
      - [Parameters](#parameters)
      - [Responses](#responses)
  - [Schemas](#schemas)
    - [SupportedFlagsResponse](#supportedflagsresponse)
    - [SupportedCountry](#supportedcountry)



# Supported Flags API Reference v1.0.0

Retrieve the list of all country and international organization flags supported by the Flags API. Returns two arrays: `supported_countries` (238 entries) with country names and ISO codes for every available country flag, and `supported_organizations` (22 entries) with case-sensitive identifiers for international organization flags (e.g., United_Nations, NATO, European_Union). Use the returned identifiers with the Flags API's name parameter to retrieve actual flag images — organization identifiers must be passed exactly as listed here, including underscores and capitalization. This endpoint takes no required parameters and has no documented error responses.

Base URLs:

* [https://api.apifreaks.com/v1.0](https://api.apifreaks.com/v1.0)

## Authentication

* API Key (ApiKeyAuthHeader)
    - Parameter Name: **X-apiKey**, in: header. Pass your API key via the X-apiKey request header.

* API Key (ApiKeyAuthQuery)
    - Parameter Name: **apiKey**, in: query. Pass your API key via the apiKey query parameter.

## Flags APIs

### getSupportedFlags

`GET /flags/supported`

*Retrieve list of all supported flags*

Returns a list of all supported country and international organization flags with their metadata.

#### Parameters

|Name|In|Type|Required|Description|
|---|---|---|---|---|
|format|query|string|false|Format of the response. Possible values: json, xml.|

##### Enumerated Values

|Parameter|Value|
|---|---|
|format|json|
|format|xml|

> Example responses

> Successful response with list of supported flags

```json
{
  "supported_countries": [
    {
      "name": "Luxembourg",
      "iso2": "LU",
      "iso3": "LUX"
    },
    {
      "name": "Suriname",
      "iso2": "SR",
      "iso3": "SUR"
    },
    {
      "name": "Tunisia",
      "iso2": "TN",
      "iso3": "TUN"
    },
    {
      "name": "Colombia",
      "iso2": "CO",
      "iso3": "COL"
    },
    {
      "name": "Pakistan",
      "iso2": "PK",
      "iso3": "PAK"
    }
  ],
  "supported_organizations": [
    "Commonwealth_of_Independent_States",
    "Gulf_Cooperation_Council",
    "Arab_League",
    "Organization_of_American_States",
    "African_Union",
    "European_Union",
    "United_Nations",
    "NATO",
    "Association_of_Southeast_Asian_Nations",
    "Commonwealth_of_Nations"
  ]
}
```

#### Responses

|Status|Meaning|Description|Schema|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Successful response with list of supported flags|[SupportedFlagsResponse](#supportedflagsresponse)|

#### Response Headers

|Status|Header|Type|Format|Description|
|---|---|---|---|---|
|200|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|

To perform this operation, you must be authenticated by means of one of the following methods:
ApiKeyAuthHeader, ApiKeyAuthQuery

## Schemas

### SupportedFlagsResponse

The full list of country and organization flag identifiers supported by the Flags API.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|supported_countries|[[SupportedCountry](#supportedcountry)]|true|none|List of all supported country flags with their ISO codes and names.|
|supported_organizations|[string]|true|none|List of all supported international organization flag identifiers.|

### SupportedCountry

A supported country with ISO codes.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|name|string|true|none|Full name of the country.|
|iso2|string|true|none|ISO 3166-1 alpha-2 code.|
|iso3|string|true|none|ISO 3166-1 alpha-3 code.|