Naar de inhoud
GET /v1/meta

Service metadata

Probeer het live

10 gratis calls per dag — geen registratie, geen API-key. Loopt via de oanor-gateway.

Aangepaste headers (optioneel)
api.oanor.com/flags-api

Het werkt. Haal een API-key op en gebruik hem in je project.

Verkrijg een API-sleutel

Codefragmenten

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_..."}
)

Voorbeeldrespons

Een echte respons van dit endpoint, vastgelegd bij de laatste 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
}