Service metadata

Code snippets

curl "https://api.oanor.com/flags-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/flags-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/flags-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/flags-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

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