SearchCtrl+K

Supported Flags API Reference

Retrieve a complete list of all supported country and international organization flags, including their names, ISO alpha-2, and ISO alpha-3 codes.

GEThttps://api.apifreaks.com/v1.0/flags/supported

Test

No parameters are required. Only your API key is needed to authenticate the request.

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/flags/supported' \
  -H 'X-apiKey: API-KEY'

Response

{
  "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"
  ]
}

API Request

Query Parameters

No parameters are required. Only your API key is needed.

API Response Schema

A successful request returns a 200 OK response with a JSON object containing supported countries and organizations arrays.

List of all supported country flags with their ISO codes and names.

supported_organizations

Array<String>mandatory

List of all supported international organization flag identifiers (e.g., "United_Nations", "NATO").

Custom Response Headers

Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Supported Flags API Reference

Retrieve a complete list of all supported country and international organization flags, including their names, ISO alpha-2, and ISO alpha-3 codes.

GEThttps://api.apifreaks.com/v1.0/flags/supported

Test

No parameters are required. Only your API key is needed to authenticate the request.

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/flags/supported' \
  -H 'X-apiKey: API-KEY'

Response

{
  "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"
  ]
}

API Request

Query Parameters

No parameters are required. Only your API key is needed.

API Response Schema

A successful request returns a 200 OK response with a JSON object containing supported countries and organizations arrays.

List of all supported country flags with their ISO codes and names.

supported_organizations

Array<String>mandatory

List of all supported international organization flag identifiers (e.g., "United_Nations", "NATO").

Custom Response Headers

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Quick Links

Quick Links

Supported Flags API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Quick Links

Quick Links

Supported Flags API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Supported Flags API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

More APIs in This Category

Admin Levels API

Administrative Units API

Admin Units Details API

Countries API

Country Details API

Cities API

Regions API

Subregions API

Flags API

Supported Flags API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

More APIs in This Category

Admin Levels API

Administrative Units API

Admin Units Details API

Countries API

Country Details API

Cities API

Regions API

Subregions API

Flags API