{ "info": { "version": "1.0", "description": "Free, open-data API marketplace from the Nordics.\n\nDeep coverage of Nordic-Baltic open-data (Estonia, Finland, Sweden, Norway,\nDenmark, Iceland, Latvia, Lithuania) plus 250+ global proxy and lookup\nAPIs. Includes a continuously growing snapshot-history layer preserving\ngrid state, power outages, border queues, weather, air quality, and more.\n\nNo authentication required for most endpoints. Free, rate-limited to\n100 req/min per IP. See https://nordapi.ee for documentation.\n", "title": "NordAPI", "license": { "name": "Free, rate-limited", "url": "https://nordapi.ee" }, "contact": { "name": "NordAPI", "url": "https://nordapi.ee" } }, "tags": [ { "name": "finance", "description": "40 endpoints for real-time and historical exchange rates across 30 currencies, cryptocurrency prices from CoinGecko, commodity spot prices (gold, oil, metals), VAT calculations for 32 EU/EEA countries, World Bank economic indicators for 200+ nations, and US congressional stock trade disclosures. Built for fintech apps, trading dashboards, pricing engines, and economic research." }, { "name": "geo", "description": "28 endpoints covering current and forecast weather from Open-Meteo, air quality indexes (PM2.5, PM10, ozone), real pollen sensor data from 16 Swiss MeteoSwiss stations (7 pollen types, hourly, 5 years of history), IP geolocation, timezone lookups, sunrise/sunset times, comprehensive country data for 250 nations, postal code lookups in 60+ countries, marine wave and swell data, live flight tracking via ADS-B, NOAA tide predictions for US coastal stations, and geocoding search to convert place names into coordinates." }, { "name": "world", "description": "21 endpoints for public holidays in 100+ countries, global shopping event calendars (Black Friday, Singles Day, Prime Day), English dictionary definitions and phonetics, Nobel Prize and laureate data from the Nobel Foundation, university search across 10,000+ institutions worldwide, WHO health indicators, remote job listings, and name demographic predictions (age, gender, nationality) powered by statistical models from government records worldwide." }, { "name": "science", "description": "29 endpoints for NASA, earthquakes, ISS, SpaceX launches, carbon footprint, UK carbon intensity, COVID-19, NOAA space weather (Kp index, solar flares, sunspots), and population-based light pollution estimates on the Bortle scale." }, { "name": "entertainment", "description": "From live Premier League scores to random cocktail recipes, top Deezer charts to anime season rankings - 68 endpoints covering TV show schedules and search via TVMaze, music search and charts from Deezer and iTunes, live sports scores from ESPN, trivia questions from Open Trivia DB, meal and cocktail recipes from TheMealDB and TheCocktailDB, 45,000+ internet radio stations, podcast search via iTunes, anime data from Jikan/MyAnimeList, dog and cat breed data, fun number and date facts, daily quotes, Pokemon from PokeAPI, Star Wars characters/planets/starships from SWAPI, song lyrics, xkcd webcomics, D&D 5e monsters/spells/classes, tarot card readings, meme templates, and Harry Potter characters by house." }, { "name": "news", "description": "8 endpoints for Hacker News top and best stories with full metadata, Wikipedia's featured articles and on-this-day events, the latest spaceflight news from SpaceflightNewsAPI, and GitHub user profiles, repositories, search, and trending repos. Perfect for building developer dashboards, news aggregators, and tech community tools." }, { "name": "food", "description": "12 endpoints for searching 3 million+ food products with nutrition data from Open Food Facts (including barcode scanning), book search and ISBN lookups via Open Library, the full Unicode emoji catalog with categories and groups, and US brewery search and discovery from Open Brewery DB covering 8,000+ breweries. Great for nutrition apps, reading lists, chat features, and local discovery tools." }, { "name": "tools", "description": "30 endpoints: UUID/password/color/lorem generators, DNS lookup, QR codes, URL shortener, WHOIS, color palettes, barcodes, SSL check, PageSpeed, bike-sharing, placeholder images, avatars, hash computation, random user generation from RandomUser.me, search, and real-time SSE streaming." }, { "name": "mashups", "description": "35 cross-domain intelligence endpoints combining multiple NordAPI sources. Includes country dossiers, travel cost calculators, salary comparisons, digital nomad scoring, aurora forecasts, energy-weather correlation, currency health, portfolio analysis, travel safety, shopping optimization, stargazing spot finder, aquatic adventure planner, climate risk assessment, commodity-currency correlation, festival finder, culinary tourism, Estonian heritage planner, border queue intelligence, power grid status, and more." }, { "name": "electricity", "description": "6 endpoints for real-time and historical Nord Pool electricity spot prices across all 9 Nordic bidding zones (NO1-NO5, SE1-SE4). Get current hour prices, full 24-hour daily breakdowns, daily statistics with cheapest/most expensive hours, historical price series, and cross-zone comparisons. Essential for smart home automation, EV charging optimization, and energy cost dashboards in Norway and Sweden." }, { "name": "art", "description": "5 endpoints for searching and exploring artworks from two of the world's greatest museums: The Metropolitan Museum of Art (470,000+ works) and the Art Institute of Chicago (100,000+ works). Search by keyword, get detailed artwork information with high-res images, or discover a random masterpiece. Perfect for educational apps, art discovery tools, and creative projects." }, { "name": "language", "description": "11 endpoints spanning classic poetry from PoetryDB (Shakespeare, Dickinson, Keats, Poe) and powerful word/language tools from Datamuse. Browse poems by author or title, search by lines, get random poetry, find rhymes, similar-meaning words, sound-alikes, autocomplete suggestions, and word associations. Great for writing tools, poetry apps, word games, and NLP projects." }, { "name": "gaming", "description": "9 endpoints for free-to-play game discovery from FreeToGame (1,000+ titles), digital game deal tracking from CheapShark (Steam, GOG, Humble Bundle), and a Deck of Cards simulator for card game apps. Filter free games by genre and platform, find the best game deals, or simulate card draws and shuffles." }, { "name": "geography", "description": "7 endpoints for elevation lookups using SRTM90m satellite data (any coordinates worldwide, single or batch), available elevation datasets, and the NHTSA vehicle database with makes, models, VIN decoding, and vehicle type lookups. Useful for hiking/cycling apps, terrain analysis, automotive tools, and fleet management." }, { "name": "scripture", "description": "2 endpoints for Bible verse lookup via bible-api.com. Look up any verse or passage by reference (e.g. John 3:16, Psalm 23:1-6), or get a random well-known verse. Returns full text, translation info, and individual verse breakdowns. Supports the World English Bible translation." }, { "name": "time", "description": "4 endpoints for current time in any timezone worldwide, time lookup by IP address, a full list of IANA timezones, and timezone conversion between any two zones. Powered by timeapi.io. Useful for scheduling apps, world clock widgets, and distributed team tools." }, { "name": "texttools", "description": "7 endpoints for URL metadata extraction and link previews via Microlink (title, description, images, screenshots), profanity detection and content filtering via PurgoMalum, and random advice from the Advice Slip API. Great for content moderation, social sharing previews, and chatbots." }, { "name": "government", "description": "3 endpoints for the US Federal Register — browse recent government documents (rules, notices, presidential documents), search by keyword, and get full document details. Free, no authentication required. Useful for legal research, regulatory compliance, and civic tech apps." }, { "name": "estonia", "description": "131 endpoints for Estonian government and city data. Weather, parliament, power grid, statistics, transport, geocoding, legislation, roads, health, power outages, utilities, 575 cameras, RIHA, elections, border queues, 12,569 monuments, 1,008 cemeteries, 4,161 sports facilities, 248 ports, 70 museums, 523 qualifications, webcams, 1,654 navigational marks, 127,000+ trademarks, 19,000+ researchers, state auctions, environmental monitoring, geology, 17,420 spatial plans, 22,452 medical devices, 209 parking zones, and a Tallinn living guide. Curated endpoints include content hashes for change detection." } ], "paths": { "/api/v1/estonian-weather/warnings": { "get": { "description": "Active weather warnings from Ilmateenistus for Estonia and surrounding sea areas. Returns warning area, content in Estonian and English, and timestamp. Includes storm warnings, wind warnings, and marine warnings.", "operationId": "estonia_ee_weather_warnings", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Weather Warnings", "tags": [ "estonia", "baltic", "weather", "realtime", "ilmateenistus", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-weather/warnings", "x-examples": {} } }, "/api/v1/mashup/nomad/score": { "get": { "description": "Calculate a livability score for any city for digital nomads, combining weather quality, cost of living (PPP-adjusted), internet infrastructure indicators, healthcare quality, safety, and visa friendliness. Optionally provide your monthly salary to see purchasing power estimates. Returns a composite score and breakdown by category. Ideal for digital nomad community platforms, remote work destination finders, and relocation planning tools.", "operationId": "mashups_nomad", "parameters": [ { "description": "City name", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } }, { "description": "Home country", "in": "query", "name": "home", "required": false, "schema": { "default": "US", "type": "string" } }, { "description": "Monthly salary", "in": "query", "name": "salary", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Digital Nomad Score", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/nomad/score?city=lisbon&salary=5000\"", "x-examples": { "Nomad score for Bali on a budget": "curl \"https://nordapi.ee/api/v1/mashup/nomad/score?city=bali&salary=3000\"", "Nomad score for Bangkok from Norway": "curl \"https://nordapi.ee/api/v1/mashup/nomad/score?city=bangkok&home=NO&salary=8000\"", "Nomad score for Berlin": "curl \"https://nordapi.ee/api/v1/mashup/nomad/score?city=berlin\"", "Nomad score for Lisbon with $5000 salary": "curl \"https://nordapi.ee/api/v1/mashup/nomad/score?city=lisbon&salary=5000\"" } } }, "/api/v1/news/spaceflight": { "get": { "description": "Get the latest spaceflight news articles from SpaceflightNewsAPI, covering rocket launches, space missions, satellite deployments, space policy, and commercial space industry developments. Returns article titles, summaries, publication dates, source names, and image URLs. Useful for space news aggregators, science dashboards, and aerospace industry monitoring tools.", "operationId": "news_spaceflight", "parameters": [ { "description": "Limit", "in": "path", "name": "limit", "required": true, "schema": { "default": "10", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Spaceflight News", "tags": [ "news", "global", "space", "realtime", "spaceflight-news-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/news/spaceflight", "x-examples": { "Latest 10 spaceflight articles": "curl https://nordapi.ee/api/v1/news/spaceflight", "Latest 5 spaceflight articles": "curl \"https://nordapi.ee/api/v1/news/spaceflight?limit=5\"" } } }, "/api/v1/ssl/{domain}": { "get": { "description": "Check the SSL/TLS certificate status for any domain. Returns certificate validity, issuer, expiration date, days until expiry, certificate chain details, and protocol support. Useful for monitoring website security, building uptime dashboards that track certificate health, alerting systems that warn before certificates expire, and security audit tools. Checks are performed in real-time against the live server.", "operationId": "tools_ssl_check", "parameters": [ { "description": "Domain", "in": "query", "name": "domain", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "SSL Certificate Check", "tags": [ "tools", "global", "dns", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/ssl/nordapi.ee", "x-examples": { "Check GitHub SSL certificate": "curl https://nordapi.ee/api/v1/ssl/github.com", "Check Google SSL certificate": "curl https://nordapi.ee/api/v1/ssl/google.com", "Check NordAPI SSL certificate": "curl https://nordapi.ee/api/v1/ssl/nordapi.ee" } } }, "/api/v1/covid/{country}": { "get": { "description": "COVID-19 statistics for a specific country including total and today's cases/deaths, recovery rate, testing rate, per-million metrics, and country flag. Useful for epidemiological research, public health dashboards, and historical analysis.", "operationId": "science_covid_country", "parameters": [ { "description": "Country name or ISO code", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "COVID-19 by Country", "tags": [ "science", "global", "health", "statistics", "lookup", "disease-sh", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/covid/norway", "x-examples": { "Japan": "curl https://nordapi.ee/api/v1/covid/japan", "Norway's COVID data": "curl https://nordapi.ee/api/v1/covid/norway", "United States": "curl https://nordapi.ee/api/v1/covid/usa" } } }, "/api/v1/avatars/generate": { "get": { "description": "Generate unique avatar image URLs from a seed string (like a username or email). Returns URLs from three different services: DiceBear (17 art styles, SVG/PNG), UI Avatars (initials-based), and RoboHash (robots/monsters). The same seed always produces the same avatar, making it perfect for user profile defaults.", "operationId": "tools_avatars_generate", "parameters": [ { "description": "Seed string (username, email, any text)", "in": "query", "name": "seed", "required": true, "schema": { "type": "string" } }, { "description": "DiceBear style name", "in": "query", "name": "style", "required": false, "schema": { "default": "avataaars", "type": "string" } }, { "description": "Image size in pixels", "in": "query", "name": "size", "required": false, "schema": { "default": "200", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Generate Avatar", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/avatars/generate?seed=john_doe\"", "x-examples": { "Avatar for a username": "curl \"https://nordapi.ee/api/v1/avatars/generate?seed=john_doe\"", "Pixel art style, large": "curl \"https://nordapi.ee/api/v1/avatars/generate?seed=jane&style=pixel-art&size=400\"", "Robot avatar from email": "curl \"https://nordapi.ee/api/v1/avatars/generate?seed=user@example.com&style=bottts\"" } } }, "/api/v1/mashup/green/energy": { "get": { "description": "Nordic green energy assessment: combines current electricity price, generation mix, carbon intensity, weather, and grid demand for any Nord Pool zone.", "operationId": "mashups_green_energy", "parameters": [ { "description": "Nord Pool zone (default NO1)", "in": "path", "name": "zone", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Green Energy Score", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/green/energy?zone=SE3\"", "x-examples": {} } }, "/api/v1/harrypotter/students": { "get": { "description": "Get all Hogwarts students from the Harry Potter universe, filtered to only include characters who attended Hogwarts School of Witchcraft and Wizardry. Returns name, house, ancestry, patronus, actor, and wand details for each student. Useful for house sorting features, student directory apps, and Hogwarts-themed quiz tools. Data from the HP-API.", "operationId": "entertainment_harrypotter_students", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Hogwarts Students", "tags": [ "entertainment", "global", "movies", "lookup", "hp-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/harrypotter/students", "x-examples": { "Browse Hogwarts student directory": "curl https://nordapi.ee/api/v1/harrypotter/students", "List all Hogwarts students": "curl https://nordapi.ee/api/v1/harrypotter/students" } } }, "/api/v1/trivia/questions": { "get": { "description": "Get random trivia questions with multiple-choice or true/false answers. Configurable by amount (up to 50), category, and difficulty level (easy/medium/hard). Returns questions with correct and incorrect answers, category, and difficulty. Useful for quiz apps, trivia games, educational tools, team-building activities, and chatbot entertainment features. Data from Open Trivia Database with 4,000+ verified questions.", "operationId": "entertainment_trivia_questions", "parameters": [ { "description": "Count", "in": "query", "name": "amount", "required": false, "schema": { "default": "10", "type": "string" } }, { "description": "Category", "in": "path", "name": "category", "required": true, "schema": { "type": "string" } }, { "description": "easy/medium/hard", "in": "query", "name": "difficulty", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Trivia Questions", "tags": [ "entertainment", "global", "games", "reference", "computed", "open-trivia", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/trivia/questions?amount=5\"", "x-examples": { "10 easy science questions": "curl \"https://nordapi.ee/api/v1/trivia/questions?amount=10&category=17&difficulty=easy\"", "20 hard history questions": "curl \"https://nordapi.ee/api/v1/trivia/questions?amount=20&category=23&difficulty=hard\"", "5 random trivia questions": "curl \"https://nordapi.ee/api/v1/trivia/questions?amount=5\"" } } }, "/api/v1/estonian-nav-marks/search": { "get": { "description": "Search navigational marks by name, region, type, or description.", "operationId": "estonia_ee_nav_marks_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Navigational Marks", "tags": [ "estonia", "baltic", "transport", "heritage", "search", "nma-vta", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-nav-marks/search?q=tuletorn\"", "x-examples": {} } }, "/api/v1/mashup/travel/inflation": { "get": { "description": "Assess travel destination value: combines exchange rates, inflation data, and purchasing power parity to show whether a destination is getting cheaper or more expensive relative to your home country.", "operationId": "mashups_inflation_travel", "parameters": [ { "description": "Destination country code", "in": "query", "name": "destination", "required": true, "schema": { "type": "string" } }, { "description": "Home country code (default US)", "in": "query", "name": "home", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Inflation-Adjusted Travel Cost", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/travel/inflation?destination=EE&home=US\"", "x-examples": {} } }, "/api/v1/curated/datasets": { "get": { "description": "List all curated (scraped) datasets with content hashes and staleness info.", "operationId": "estonia_ee_curated_datasets", "parameters": [ { "description": "Filter by stale=true for datasets needing refresh", "in": "query", "name": "stale", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Curated Datasets", "tags": [ "estonia", "baltic", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/curated/datasets", "x-examples": {} } }, "/api/v1/github/search": { "get": { "description": "Search across all public GitHub repositories by keyword. Returns matching repos with names, descriptions, star counts, fork counts, languages, and owner information. Useful for finding open source libraries, discovering projects in specific technology stacks, competitive analysis, and building developer tool recommendation engines. Data from the GitHub Search API.", "operationId": "news_github_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Repos", "tags": [ "news", "global", "social", "search", "github", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/github/search?q=elixir+phoenix\"", "x-examples": { "Search for Elixir Phoenix repos": "curl \"https://nordapi.ee/api/v1/github/search?q=elixir+phoenix\"", "Search for React component libraries": "curl \"https://nordapi.ee/api/v1/github/search?q=react+components\"", "Search for machine learning projects": "curl \"https://nordapi.ee/api/v1/github/search?q=machine+learning\"" } } }, "/api/v1/elevation/datasets": { "get": { "description": "List available elevation datasets with their coverage areas and resolutions.", "operationId": "geography_elevation_datasets", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Elevation Datasets", "tags": [ "geography", "global", "lookup", "open-topo-data", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/elevation/datasets", "x-examples": {} } }, "/api/v1/breweries/country/{country}": { "get": { "description": "Find all breweries in a specific country. Returns brewery names, types, addresses, and contact information. Use underscores for multi-word country names (e.g., united_states). Useful for country-level brewery directories, international craft beer market analysis, and tourism apps highlighting a nation's brewery scene. Data from Open Brewery DB.", "operationId": "food_breweries_country", "parameters": [ { "description": "Country", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Breweries by Country", "tags": [ "food", "global", "drinks", "business", "lookup", "breweries", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/breweries/country/united_states", "x-examples": { "Breweries in England": "curl https://nordapi.ee/api/v1/breweries/country/england", "Breweries in Germany": "curl https://nordapi.ee/api/v1/breweries/country/germany", "Breweries in the United States": "curl https://nordapi.ee/api/v1/breweries/country/united_states" } } }, "/api/v1/currencies/{code}/countries": { "get": { "description": "Find all countries that use a specific currency. For example, querying EUR returns all 20 Eurozone nations. Returns country codes and names for each match. Useful for understanding the geographic reach of a currency, building educational tools, or determining which countries are affected when a particular currency fluctuates.", "operationId": "finance_currency_countries", "parameters": [ { "description": "Currency code in URL", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Countries by Currency", "tags": [ "finance", "global", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/currencies/EUR/countries", "x-examples": { "Countries using GBP": "curl https://nordapi.ee/api/v1/currencies/GBP/countries", "Countries using USD": "curl https://nordapi.ee/api/v1/currencies/USD/countries", "Countries using the Euro": "curl https://nordapi.ee/api/v1/currencies/EUR/countries" } } }, "/api/v1/shopping/check": { "get": { "description": "Check whether today is a shopping holiday or sale event in a specific country. Returns a boolean result along with event details if active. Useful for triggering automated sale banners, sending push notifications about ongoing deals, and adjusting pricing strategies during major shopping events like Black Friday.", "operationId": "world_shopping_check", "parameters": [ { "description": "Country", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Check Shopping Holiday", "tags": [ "world", "global", "business", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/shopping/check?country=US\"", "x-examples": { "Check Chinese shopping holidays today": "curl \"https://nordapi.ee/api/v1/shopping/check?country=CN\"", "Check UK shopping holidays today": "curl \"https://nordapi.ee/api/v1/shopping/check?country=GB\"", "Check US shopping holidays today": "curl \"https://nordapi.ee/api/v1/shopping/check?country=US\"" } } }, "/api/v1/museum/met/{id}": { "get": { "description": "Get detailed information about a specific artwork in the Met Museum by its object ID. Returns title, artist, date, medium, dimensions, department, culture, period, and high-resolution image URL.", "operationId": "art_met_object", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Get Met Artwork", "tags": [ "art", "global", "heritage", "lookup", "met-museum", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/museum/met/45734", "x-examples": {} } }, "/api/v1/estonian-environment/programs": { "get": { "description": "All 294 environmental monitoring programs in Estonia — air quality, water, soil, biodiversity, radiation, noise, and more. Each program has a code, name, validity period, and associated species/taxons. From KESE (kese.envir.ee).", "operationId": "estonia_ee_env_programs", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Environmental Monitoring Programs", "tags": [ "estonia", "baltic", "environment", "lookup", "kese-envir", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-environment/programs", "x-examples": {} } }, "/api/v1/estonian-geology/layers": { "get": { "description": "Available WMS map layers from the Estonian Geology Fund GeoServer. 60+ layers covering geology, hydrogeology, mineral deposits, geomorphology, and bedrock.", "operationId": "estonia_ee_geology_layers", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Geological Map Layers", "tags": [ "estonia", "baltic", "environment", "science", "lookup", "egf-fond", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-geology/layers", "x-examples": {} } }, "/api/v1/compare": { "get": { "description": "Compare a currency pair's current rate against its rate from yesterday, 1 week ago, 1 month ago, 3 months ago, and 1 year ago, with percentage change for each period. Gives instant context about whether a currency is trending up or down over different timeframes. Perfect for currency converter apps that want to show users if now is a good or bad time to exchange.", "operationId": "finance_compare", "parameters": [ { "description": "Base currency", "in": "query", "name": "base", "required": true, "schema": { "type": "string" } }, { "description": "Target currency", "in": "query", "name": "target", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Period Comparison", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/compare?base=EUR&target=USD\"", "x-examples": { "EUR/USD period comparison": "curl \"https://nordapi.ee/api/v1/compare?base=EUR&target=USD\"", "GBP/NOK period comparison": "curl \"https://nordapi.ee/api/v1/compare?base=GBP&target=NOK\"", "USD/SEK period comparison": "curl \"https://nordapi.ee/api/v1/compare?base=USD&target=SEK\"" } } }, "/api/v1/food/search": { "get": { "description": "Search over 3 million food products worldwide from the Open Food Facts database. Returns product names, brands, nutrition facts (calories, fat, sugar, protein, fiber, salt per serving), Nutri-Score health grades, allergen information, and barcode numbers. Ideal for nutrition tracking apps, dietary planning tools, food comparison features, and health-conscious shopping assistants.", "operationId": "food_food_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Food Product Search", "tags": [ "food", "global", "search", "open-food-facts", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/food/search?q=nutella\"", "x-examples": { "Search for Nutella products": "curl \"https://nordapi.ee/api/v1/food/search?q=nutella\"", "Search for oat milk products": "curl \"https://nordapi.ee/api/v1/food/search?q=oat+milk\"", "Search for protein bars": "curl \"https://nordapi.ee/api/v1/food/search?q=protein+bar\"" } } }, "/api/v1/hash/algorithms": { "get": { "description": "List all supported cryptographic hash algorithms with their names. Currently supports MD5, SHA-1, SHA-256, SHA-384, and SHA-512.", "operationId": "tools_hash_algorithms", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Supported Hash Algorithms", "tags": [ "tools", "global", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/hash/algorithms", "x-examples": {} } }, "/api/v1/tallinn/water": { "get": { "description": "Lake Ülemiste - Tallinn's drinking water source since 1922. Area, depth, treatment plant capacity (60,000 m³/day), 30,000 annual samples, quality standards, and tap water safety info.", "operationId": "estonia_tallinn_water", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Water Supply", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-life", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/water", "x-examples": {} } }, "/api/v1/estonian-medical-devices": { "get": { "description": "22,452 medical devices registered in Estonia from the MSA database (msa.sm.ee). Includes manufacturers, risk classes, UDI codes, and purpose.", "operationId": "estonia_ee_medical_devices", "parameters": [ { "description": "Risk class filter (I, IIa, IIb, III)", "in": "query", "name": "risk_class", "required": false, "schema": { "type": "string" } }, { "description": "Manufacturer name filter", "in": "query", "name": "manufacturer", "required": false, "schema": { "type": "string" } }, { "description": "Results per page (max 200)", "in": "path", "name": "limit", "required": true, "schema": { "default": "50", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Medical Devices", "tags": [ "estonia", "baltic", "health", "civic", "lookup", "msa-sm", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-medical-devices", "x-examples": {} } }, "/api/v1/tides/stations": { "get": { "description": "List all available US coastal tide monitoring stations from NOAA (National Oceanic and Atmospheric Administration). Returns station IDs, names, and locations. Use this to find valid station IDs for the tide prediction, water level, and temperature endpoints. Covers major US coastal areas on the Atlantic, Pacific, and Gulf coasts.", "operationId": "geo_tides_stations", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tide Stations", "tags": [ "geo", "united-states", "americas", "weather", "reference", "lookup", "noaa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tides/stations", "x-examples": {} } }, "/api/v1/estonian-trademarks/count": { "get": { "description": "Get the total number of trademarks in the Estonian Patent Office database.", "operationId": "estonia_ee_trademarks_count", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Trademark Count", "tags": [ "estonia", "baltic", "business", "legal", "computed", "epa-andmebaas", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-trademarks/count", "x-examples": {} } }, "/api/v1/tallinn/data/tables": { "get": { "description": "List all available datasets from the Tallinn City open data portal (avaandmed.tallinn.ee). Returns table names with descriptions: population, budget, road closures, building permits, excavation permits, city plans, addresses, and transport.", "operationId": "estonia_tallinn_data_tables", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Open Data Tables", "tags": [ "estonia", "baltic", "civic", "lookup", "avaandmed-tallinn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/data/tables", "x-examples": {} } }, "/api/v1/electricity/compare": { "get": { "description": "Compare electricity spot prices across all 9 Nordic bidding zones side by side for today or a specified date. Shows the current price in each zone with currency in EUR/MWh and local currency equivalents. Useful for identifying the cheapest and most expensive electricity regions right now, building cross-zone comparison dashboards, and helping businesses with multi-location operations optimize energy purchasing. Data from Nord Pool.", "operationId": "electricity_compare", "parameters": [ { "description": "Date", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Zone Comparison", "tags": [ "electricity", "global", "nordic", "power", "realtime", "hvakosterstrommen", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/electricity/compare", "x-examples": { "Compare all zones on a specific date": "curl \"https://nordapi.ee/api/v1/electricity/compare?date=2026-03-20\"", "Compare all zones today": "curl https://nordapi.ee/api/v1/electricity/compare" } } }, "/api/v1/dns/lookup": { "get": { "description": "Perform DNS record lookups for any domain name. Supports all major record types: A (IPv4 address), AAAA (IPv6), MX (mail servers), CNAME (canonical name), TXT (text records including SPF/DKIM), NS (nameservers), and SOA (start of authority). Useful for domain troubleshooting tools, email deliverability checkers, DNS monitoring dashboards, and network administration utilities.", "operationId": "tools_dns_lookup", "parameters": [ { "description": "Domain", "in": "query", "name": "domain", "required": true, "schema": { "type": "string" } }, { "description": "Record type", "in": "path", "name": "type", "required": true, "schema": { "default": "A", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "DNS Lookup", "tags": [ "tools", "global", "dns", "lookup", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/dns/lookup?domain=nordapi.ee&type=A\"", "x-examples": { "A record lookup for nordapi.ee": "curl \"https://nordapi.ee/api/v1/dns/lookup?domain=nordapi.ee&type=A\"", "MX records for Gmail": "curl \"https://nordapi.ee/api/v1/dns/lookup?domain=gmail.com&type=MX\"", "TXT records for a domain": "curl \"https://nordapi.ee/api/v1/dns/lookup?domain=google.com&type=TXT\"" } } }, "/api/v1/federal/recent": { "get": { "description": "Browse recent US Federal Register documents including rules, proposed rules, notices, and presidential documents. Supports pagination and type filtering.", "operationId": "government_federal_recent", "parameters": [ { "description": "Results per page (max 50)", "in": "query", "name": "per_page", "required": false, "schema": { "default": "10", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "type": "string" } }, { "description": "Document type: RULE, PRORULE, NOTICE, PRESDOCU", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Recent Federal Documents", "tags": [ "government", "united-states", "americas", "legal", "civic", "search", "federal-register", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/federal/recent?per_page=5\"", "x-examples": {} } }, "/api/v1/estonian-ports/search": { "get": { "description": "Search Estonian ports by name or address.", "operationId": "estonia_ee_ports_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Ports", "tags": [ "estonia", "baltic", "transport", "travel", "search", "sadamaregister", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-ports/search?q=Tallinn\"", "x-examples": {} } }, "/api/v1/mashup/business/expansion": { "get": { "description": "Get a comprehensive market analysis report for international business expansion, combining economic indicators (GDP, growth, inflation), currency stability, VAT rates, workforce data, and comparison to your home market. Returns a structured report with key metrics for evaluating whether a country is a viable expansion target. Useful for market entry strategy, international business development, and investment due diligence.", "operationId": "mashups_business", "parameters": [ { "description": "Target market", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } }, { "description": "Home market", "in": "query", "name": "home", "required": false, "schema": { "default": "US", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Business Expansion", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/business/expansion?country=PL\"", "x-examples": { "Evaluate Estonia for Nordic expansion": "curl \"https://nordapi.ee/api/v1/mashup/business/expansion?country=EE&home=NO\"", "Evaluate Japan from a UK home market": "curl \"https://nordapi.ee/api/v1/mashup/business/expansion?country=JP&home=GB\"", "Evaluate Poland for business expansion": "curl \"https://nordapi.ee/api/v1/mashup/business/expansion?country=PL\"" } } }, "/api/v1/iss/tle": { "get": { "description": "Get the Two-Line Element (TLE) set for the International Space Station - the standard format used to describe satellite orbits. TLE data includes orbital inclination, eccentricity, argument of perigee, mean motion, and epoch. Used by satellite tracking software (like SGP4 propagators) to predict the ISS position at any future time. Essential for building custom orbital prediction tools and pass-time calculators.", "operationId": "science_iss_tle", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "ISS TLE Data", "tags": [ "science", "global", "space", "lookup", "wheretheiss-at", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/iss/tle", "x-examples": {} } }, "/api/v1/estonian-qualifications/standards": { "get": { "description": "Browse 523 professional qualification standards from kutseregister.ee.", "operationId": "estonia_ee_qualifications", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Qualification Standards", "tags": [ "estonia", "baltic", "education", "reference", "lookup", "kutseregister", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-qualifications/standards", "x-examples": {} } }, "/api/v1/federal/{number}": { "get": { "description": "Get full details of a specific Federal Register document by its document number.", "operationId": "government_federal_show", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Federal Document Details", "tags": [ "government", "united-states", "americas", "legal", "civic", "lookup", "federal-register", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/federal/2024-12345", "x-examples": {} } }, "/api/v1/electricity/stats/{zone}": { "get": { "description": "Get daily electricity price statistics for a specific Nordic bidding zone, including the minimum, maximum, and average price for the day, plus the cheapest and most expensive hours. Optionally specify a date for historical stats. Useful for daily energy cost summaries, historical price analysis, and helping consumers understand their electricity cost patterns without processing all 24 hourly data points themselves. Data from Nord Pool.", "operationId": "electricity_stats", "parameters": [ { "description": "Zone", "in": "path", "name": "zone", "required": true, "schema": { "type": "string" } }, { "description": "Date", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Daily Stats", "tags": [ "electricity", "global", "nordic", "power", "computed", "hvakosterstrommen", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/electricity/stats/NO1", "x-examples": { "Stats for Stockholm on a past date": "curl \"https://nordapi.ee/api/v1/electricity/stats/SE3?date=2026-03-20\"", "Stats for Tromsoe area (NO4)": "curl https://nordapi.ee/api/v1/electricity/stats/NO4", "Today's stats for Oslo (NO1)": "curl https://nordapi.ee/api/v1/electricity/stats/NO1" } } }, "/api/v1/estonian-nav-marks/types": { "get": { "description": "List all types of navigational marks in Estonian waters with counts. Types include Tuletorn (lighthouse), Tulepaak (beacon), Poi (buoy), Tooder (spar buoy), and leading line marks.", "operationId": "estonia_ee_nav_marks_types", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Navigational Mark Types", "tags": [ "estonia", "baltic", "transport", "heritage", "lookup", "nma-vta", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-nav-marks/types", "x-examples": {} } }, "/api/v1/zipcode/{country}/{code}": { "get": { "description": "Look up a postal/zip code in 60+ countries to get the associated city, state/province, and geographic coordinates. Provide the country code and postal code in the URL. Useful for address validation, auto-filling city and state fields in checkout forms, calculating shipping zones, and mapping postal code regions. Covers the US, Canada, most of Europe, and many other countries.", "operationId": "geo_zipcode_lookup", "parameters": [ { "description": "Country code", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } }, { "description": "Postal code", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Postal Code Lookup", "tags": [ "geo", "global", "geography", "lookup", "zippopotam", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/zipcode/us/90210", "x-examples": { "Beverly Hills zip code (US)": "curl https://nordapi.ee/api/v1/zipcode/us/90210", "London postal code (UK)": "curl https://nordapi.ee/api/v1/zipcode/gb/SW1A", "Oslo postal code (Norway)": "curl https://nordapi.ee/api/v1/zipcode/no/0150" } } }, "/api/v1/carbon/factors": { "get": { "description": "Get a comprehensive list of carbon emission factors for common activities including driving, flying (short/medium/long haul), electricity usage, heating, and more. Each factor shows the CO2 equivalent in kilograms per unit of activity. Use this reference data to understand available activities before calling the carbon calculator. Essential for building environmental impact tools and sustainability dashboards.", "operationId": "science_carbon_factors", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Carbon Emission Factors", "tags": [ "science", "global", "environment", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/carbon/factors", "x-examples": {} } }, "/api/v1/starwars/planets/search": { "get": { "description": "Search for planets in the Star Wars universe by name. Returns planet names, climate, terrain, population, gravity, orbital period, rotation period, and diameter. Data from SWAPI covering all canonical Star Wars planets from the films. Useful for worldbuilding references, Star Wars geography explorers, and sci-fi trivia applications.", "operationId": "entertainment_starwars_search_planets", "parameters": [ { "description": "Planet name search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Star Wars Planet Search", "tags": [ "entertainment", "global", "movies", "search", "star-wars-api", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/starwars/planets/search?q=tatooine\"", "x-examples": { "Search for Hoth": "curl \"https://nordapi.ee/api/v1/starwars/planets/search?q=hoth\"", "Search for Naboo": "curl \"https://nordapi.ee/api/v1/starwars/planets/search?q=naboo\"", "Search for Tatooine": "curl \"https://nordapi.ee/api/v1/starwars/planets/search?q=tatooine\"" } } }, "/api/v1/words/nouns/{adjective}": { "get": { "description": "Find nouns commonly described by a given adjective. Useful for word association and language learning tools.", "operationId": "language_words_nouns", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Nouns for Adjective", "tags": [ "language", "global", "lookup", "datamuse", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/words/nouns/beautiful", "x-examples": {} } }, "/api/v1/peatus/stops": { "get": { "description": "Search public transport stops across all of Estonia by name. Returns stop name, GTFS ID, coordinates, and type. Data from Peatus.ee covering all buses, trains, trams, and trolleybuses nationwide.", "operationId": "estonia_peatus_stops", "parameters": [ { "description": "Stop name to search (e.g. Viru, Balti jaam, Tartu)", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Transport Stops", "tags": [ "estonia", "baltic", "transport", "search", "peatus-ee", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/peatus/stops?name=Viru\"", "x-examples": {} } }, "/api/v1/words/sounds/{word}": { "get": { "description": "Find words that sound similar to the given word (homophones and near-homophones). Useful for spelling correction and pun generators.", "operationId": "language_words_sounds", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Words That Sound Like", "tags": [ "language", "global", "lookup", "datamuse", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/words/sounds/flower", "x-examples": {} } }, "/api/v1/maaamet/reverse": { "get": { "description": "Reverse geocode Estonian L-EST97 coordinates to addresses. Returns the nearest addresses for given X,Y coordinates in the Estonian national grid system.", "operationId": "estonia_maaamet_reverse", "parameters": [ { "description": "L-EST97 X coordinate (easting)", "in": "query", "name": "x", "required": true, "schema": { "type": "string" } }, { "description": "L-EST97 Y coordinate (northing)", "in": "query", "name": "y", "required": true, "schema": { "type": "string" } }, { "description": "Max results", "in": "query", "name": "results", "required": false, "schema": { "default": "5", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Reverse Geocode", "tags": [ "estonia", "baltic", "geography", "lookup", "maa-amet", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/maaamet/reverse?x=542228&y=6588522\"", "x-examples": {} } }, "/api/v1/news/hackernews/best": { "get": { "description": "Get the highest-voted Hacker News stories over a longer time period (the 'best' ranking emphasizes total score over recency). Returns story titles, URLs, scores, comment counts, and authors. Useful for discovering the most impactful tech stories you might have missed, building 'best of HN' digests, and curating high-quality developer content. Data from the Hacker News API.", "operationId": "news_hn_best", "parameters": [ { "description": "Limit", "in": "path", "name": "limit", "required": true, "schema": { "default": "20", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "HN Best Stories", "tags": [ "news", "global", "social", "realtime", "hacker-news", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/news/hackernews/best", "x-examples": { "Best 10 HN stories": "curl \"https://nordapi.ee/api/v1/news/hackernews/best?limit=10\"", "Best 20 HN stories (default)": "curl https://nordapi.ee/api/v1/news/hackernews/best" } } }, "/api/v1/space/launches/latest": { "get": { "description": "Get details about the most recent rocket launch worldwide, including mission name, launch provider, rocket type, launch site, date/time, and mission outcome. Covers launches from SpaceX, NASA, Roscosmos, ESA, ISRO, and all other space agencies and private companies. Useful for space news feeds, launch history databases, and aerospace industry tracking tools.", "operationId": "science_space_latest", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Latest Launch", "tags": [ "science", "global", "space", "lookup", "spacexdata", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/space/launches/latest", "x-examples": {} } }, "/api/v1/anime/season": { "get": { "description": "Get all anime currently airing this season, with titles, episode counts, airing schedules, synopses, and ratings. Useful for seasonal anime tracking apps, 'what's new this season' features, and helping fans keep up with the latest releases. Data from Jikan/MyAnimeList, updated as new shows premiere each anime season (Winter, Spring, Summer, Fall).", "operationId": "entertainment_anime_season", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Current Season", "tags": [ "entertainment", "global", "anime", "scheduled", "jikan", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/anime/season", "x-examples": {} } }, "/api/v1/generate/lorem": { "get": { "description": "Generate Lorem Ipsum placeholder text with a configurable number of paragraphs (default 3). Returns classic Latin-based dummy text used in design, typesetting, and web development to fill layouts before real content is available. Useful for design mockups, content management system development, print layout testing, and any prototype that needs realistic-looking text blocks.", "operationId": "tools_generate_lorem", "parameters": [ { "description": "Paragraphs", "in": "query", "name": "paragraphs", "required": false, "schema": { "default": "3", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Lorem Ipsum", "tags": [ "tools", "global", "generators", "text", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/generate/lorem?paragraphs=3\"", "x-examples": { "Generate 1 paragraph": "curl \"https://nordapi.ee/api/v1/generate/lorem?paragraphs=1\"", "Generate 10 paragraphs": "curl \"https://nordapi.ee/api/v1/generate/lorem?paragraphs=10\"", "Generate 3 paragraphs (default)": "curl \"https://nordapi.ee/api/v1/generate/lorem\"" } } }, "/api/v1/tallinn/cameras/areas": { "get": { "description": "List all camera filter areas: 8 city districts (Kesklinn, Lasnamäe, etc.) and 18 road corridors (Narva mnt, Pärnu mnt, Tartu mnt, etc.).", "operationId": "estonia_tallinn_camera_areas", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Camera Areas", "tags": [ "estonia", "baltic", "cameras", "lookup", "tallinn-cameras", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/cameras/areas", "x-examples": {} } }, "/api/v1/elections/ee/{election}/turnout": { "get": { "description": "Voter turnout for a specific election: total voters, paper voters, online voters, eligible voters, and turnout percentage. Estonia pioneered internet voting.", "operationId": "estonia_elections_turnout", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Election Turnout", "tags": [ "estonia", "baltic", "elections", "civic", "lookup", "valimised", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/elections/ee/KOV_2025/turnout", "x-examples": {} } }, "/api/v1/tallinn/legal-acts": { "get": { "description": "City Council and Government legal acts from teele.tallinn.ee.", "operationId": "estonia_ee_legal_acts", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Legal Acts", "tags": [ "estonia", "baltic", "legal", "civic", "lookup", "teele-tallinn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/legal-acts", "x-examples": {} } }, "/api/v1/crypto/search": { "get": { "description": "Search across the top 250 cryptocurrencies by name or ticker symbol. Returns matching coins with their ID, symbol, name, and current price. Useful for building autocomplete search fields in crypto apps, letting users find and add coins to watchlists, or resolving ambiguous ticker symbols to the correct coin.", "operationId": "finance_crypto_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Crypto Search", "tags": [ "finance", "global", "crypto", "search", "coingecko", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/crypto/search?q=ethereum\"", "x-examples": { "Search by ticker symbol": "curl \"https://nordapi.ee/api/v1/crypto/search?q=SOL\"", "Search for Ethereum": "curl \"https://nordapi.ee/api/v1/crypto/search?q=ethereum\"", "Search for dog-themed coins": "curl \"https://nordapi.ee/api/v1/crypto/search?q=doge\"" } } }, "/api/v1/tallinn/parking-zones/search": { "get": { "description": "Search 209 parking zones across Tallinn, Narva, Tartu, and other Estonian cities by zone name or street address. Returns GPS coordinates and polygon boundaries.", "operationId": "estonia_tln_parking_zones_search", "parameters": [ { "description": "Search query (zone name or street address)", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Parking Zones", "tags": [ "estonia", "baltic", "transport", "civic", "search", "parkimine", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/tallinn/parking-zones/search?q=kesklinn\"", "x-examples": {} } }, "/api/v1/breweries/random": { "get": { "description": "Discover a random brewery from the Open Brewery DB collection. Returns full brewery details including name, type, address, city, country, phone, and website. Great for 'discover a new brewery' features, random exploration tools, and adding serendipitous discovery to craft beer apps.", "operationId": "food_breweries_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Brewery", "tags": [ "food", "global", "drinks", "business", "lookup", "breweries", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/breweries/random", "x-examples": {} } }, "/api/v1/games/deals": { "get": { "description": "Find the best digital game deals across Steam, GOG, Humble Bundle, and more stores. Filter by price, store, and sort by savings or Metacritic score.", "operationId": "gaming_game_deals", "parameters": [ { "description": "Search by game title", "in": "query", "name": "title", "required": false, "schema": { "type": "string" } }, { "description": "Maximum price in USD", "in": "query", "name": "upperPrice", "required": false, "schema": { "type": "string" } }, { "description": "Minimum price in USD", "in": "query", "name": "lowerPrice", "required": false, "schema": { "type": "string" } }, { "description": "Filter by store ID", "in": "query", "name": "storeID", "required": false, "schema": { "type": "string" } }, { "description": "Sort: Deal Rating, Title, Savings, Price, Metacritic, Reviews, Release, Store, recent", "in": "query", "name": "sortBy", "required": false, "schema": { "type": "string" } }, { "description": "Results per page (max 60)", "in": "query", "name": "pageSize", "required": false, "schema": { "default": "10", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Game Deals", "tags": [ "gaming", "global", "games", "search", "cheapshark", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/games/deals?upperPrice=15&sortBy=Metacritic\"", "x-examples": {} } }, "/api/v1/tallinn/museums": { "get": { "description": "All Tallinn museums with addresses, free Museum Sunday dates for 2026 (first Sunday of each month), and other museums like KUMU, Lennusadam, and the TV Tower. Includes pre-registration requirements.", "operationId": "estonia_tallinn_museums", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Museums & Free Days", "tags": [ "estonia", "baltic", "heritage", "civic", "lookup", "tallinn-life", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/museums", "x-examples": {} } }, "/api/v1/estonian-roads/parking": { "get": { "description": "Roadside parking areas along Estonian roads with capacity, facilities, equipment, security info, and contact details.", "operationId": "estonia_ee_parking", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Roadside Parking", "tags": [ "estonia", "baltic", "transport", "lookup", "transpordiamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-roads/parking", "x-examples": {} } }, "/api/v1/range": { "get": { "description": "Find the minimum, maximum, and average exchange rate for any currency pair over a custom date range. Returns the exact dates when the high and low occurred, making it easy to identify the best and worst conversion moments. Useful for negotiating contract rates, analyzing seasonal currency patterns, and providing users with context about current rates relative to recent history.", "operationId": "finance_range", "parameters": [ { "description": "Base currency", "in": "query", "name": "base", "required": true, "schema": { "type": "string" } }, { "description": "Target currency", "in": "query", "name": "target", "required": true, "schema": { "type": "string" } }, { "description": "Start date", "in": "query", "name": "start_date", "required": true, "schema": { "type": "string" } }, { "description": "End date", "in": "query", "name": "end_date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "High / Low / Average", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/range?base=EUR&target=USD&start_date=2026-03-19&end_date=2026-03-24\"", "x-examples": { "EUR/USD range over one week": "curl \"https://nordapi.ee/api/v1/range?base=EUR&target=USD&start_date=2026-03-17&end_date=2026-03-24\"", "GBP/NOK range over a month": "curl \"https://nordapi.ee/api/v1/range?base=GBP&target=NOK&start_date=2026-02-01&end_date=2026-02-28\"", "USD/JPY range over a quarter": "curl \"https://nordapi.ee/api/v1/range?base=USD&target=JPY&start_date=2026-01-01&end_date=2026-03-24\"" } } }, "/api/v1/estonian-weather/forecast": { "get": { "description": "4-day weather forecast for Estonia from Ilmateenistus. Includes day and night forecasts with phenomena, temperature ranges, text descriptions, and place-specific predictions for major Estonian cities. Available in English and Estonian.", "operationId": "estonia_ee_weather_forecast", "parameters": [ { "description": "Language: eng or est", "in": "query", "name": "lang", "required": false, "schema": { "default": "eng", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Weather Forecast", "tags": [ "estonia", "baltic", "weather", "scheduled", "ilmateenistus", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-weather/forecast", "x-examples": {} } }, "/api/v1/estonian-roads/restrictions": { "get": { "description": "Current traffic restrictions on Estonian roads including road closures, weight limits, and construction zones with affected road segments and date ranges.", "operationId": "estonia_ee_road_restrictions", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Road Restrictions", "tags": [ "estonia", "baltic", "transport", "realtime", "transpordiamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-roads/restrictions", "x-examples": {} } }, "/api/v1/crypto/convert": { "get": { "description": "Convert any cryptocurrency amount into any of the 30 supported fiat currencies using live CoinGecko prices and ECB exchange rates. Returns the conversion rate and calculated result. Ideal for crypto portfolio apps that need to show holdings in local currency, payment processors converting crypto to fiat, and trading tools that need quick fiat-equivalent calculations.", "operationId": "finance_crypto_convert", "parameters": [ { "description": "Coin ID", "in": "query", "name": "coin", "required": true, "schema": { "type": "string" } }, { "description": "Target fiat currency", "in": "query", "name": "to", "required": true, "schema": { "type": "string" } }, { "description": "Amount of crypto", "in": "query", "name": "amount", "required": false, "schema": { "default": "1", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Crypto to Fiat Conversion", "tags": [ "finance", "global", "crypto", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/crypto/convert?coin=bitcoin&to=NOK&amount=1\"", "x-examples": { "1 Bitcoin to Norwegian Krone": "curl \"https://nordapi.ee/api/v1/crypto/convert?coin=bitcoin&to=NOK&amount=1\"", "10 Ethereum to EUR": "curl \"https://nordapi.ee/api/v1/crypto/convert?coin=ethereum&to=EUR&amount=10\"", "1000 Solana to USD": "curl \"https://nordapi.ee/api/v1/crypto/convert?coin=solana&to=USD&amount=1000\"" } } }, "/api/v1/pair/{base}/{target}": { "get": { "description": "Get a detailed profile for a specific currency pair, including the latest rate, recent historical rates, and percentage change over time. Designed for building dedicated currency pair pages (e.g., EUR/USD detail view) with trend information. More focused than the general rates endpoint, giving you pair-specific analytics in one call.", "operationId": "finance_pair", "parameters": [ { "description": "Base currency in URL", "in": "query", "name": "base", "required": true, "schema": { "type": "string" } }, { "description": "Target currency in URL", "in": "query", "name": "target", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Currency Pair Detail", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/pair/EUR/USD", "x-examples": { "EUR/USD pair detail": "curl https://nordapi.ee/api/v1/pair/EUR/USD", "GBP/NOK pair detail": "curl https://nordapi.ee/api/v1/pair/GBP/NOK", "USD/JPY pair detail": "curl https://nordapi.ee/api/v1/pair/USD/JPY" } } }, "/api/v1/elections/ee": { "get": { "description": "List all Estonian elections with open data: local government (KOV), parliament (RK), European Parliament (EP). Includes content hash for change detection.", "operationId": "estonia_elections_list", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Elections", "tags": [ "estonia", "baltic", "elections", "civic", "lookup", "valimised", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/elections/ee", "x-examples": {} } }, "/api/v1/stream/topics": { "get": { "description": "List all 14 available streaming topics with descriptions, update frequencies, and supported filters. Each topic can be filtered to specific items (e.g. crypto:bitcoin, electricity:NO1, exchange_rates:EUR/USD). Also shows JavaScript EventSource and curl usage examples.", "operationId": "tools_stream_topics", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Stream Topics & Filters", "tags": [ "tools", "global", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/stream/topics", "x-examples": {} } }, "/api/v1/estonian-weather/station/{name}": { "get": { "description": "Get current weather data for a specific Estonian weather station by name (case-insensitive partial match). Stations include Tallinn-Harku, Tartu-Tõravere, Pärnu, Narva, Kuressaare, Võru, and more.", "operationId": "estonia_ee_weather_station", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Weather Station", "tags": [ "estonia", "baltic", "weather", "realtime", "ilmateenistus", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-weather/station/tallinn", "x-examples": {} } }, "/api/v1/museum/random": { "get": { "description": "Discover a random artwork from the Art Institute of Chicago's collection. Great for 'artwork of the day' features, creative inspiration, or educational tools.", "operationId": "art_museum_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Artwork", "tags": [ "art", "global", "heritage", "lookup", "artic", "cc-by", "none" ], "x-example": "curl https://nordapi.ee/api/v1/museum/random", "x-examples": {} } }, "/api/v1/tides/level/{station}": { "get": { "description": "Get the current real-time water level reading at a specific NOAA tide station. Returns the latest observed water level measurement. Useful for coastal flooding alerts, harbor management, dock scheduling, and comparing actual water levels to predicted tides. Data is from live NOAA sensors updated in near real-time.", "operationId": "geo_tides_level", "parameters": [ { "description": "Station ID", "in": "path", "name": "station", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Water Level", "tags": [ "geo", "united-states", "americas", "weather", "realtime", "noaa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tides/level/9414290", "x-examples": { "Water level at San Francisco": "curl https://nordapi.ee/api/v1/tides/level/9414290", "Water level at Seattle": "curl https://nordapi.ee/api/v1/tides/level/9447130" } } }, "/api/v1/estonian-webcams/categories": { "get": { "description": "List all webcam categories with camera counts.", "operationId": "estonia_ee_webcam_categories", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Webcam Categories", "tags": [ "estonia", "baltic", "cameras", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-webcams/categories", "x-examples": {} } }, "/api/v1/spaceweather/flares/history": { "get": { "description": "Historical GOES X-ray flare flux readings archived continuously. Filter by ?energy band (short/long) and ?start/?end. Useful for studying solar flare distributions, correlating flares with aurora or radio-blackout events, and long-term analysis of solar-cycle activity.", "operationId": "science_spaceweather_flares_history", "parameters": [ { "description": "Energy band filter", "in": "query", "name": "energy", "required": false, "schema": { "type": "string" } }, { "description": "Start datetime", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Solar Flare History", "tags": [ "science", "global", "geomagnetic", "space", "snapshot-history", "noaa-swpc", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/spaceweather/flares/history?limit=500\"", "x-examples": {} } }, "/api/v1/generate/password": { "get": { "description": "Generate a cryptographically secure random password with configurable length (default 16 characters). Includes uppercase, lowercase, numbers, and special characters for maximum strength. Useful for password manager apps, account creation flows, security tools, and any feature where users need help creating strong passwords. Never reuses or stores generated passwords.", "operationId": "tools_generate_password", "parameters": [ { "description": "Length", "in": "query", "name": "length", "required": false, "schema": { "default": "16", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Password Generator", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/generate/password?length=20\"", "x-examples": { "Generate a 16-character password (default)": "curl \"https://nordapi.ee/api/v1/generate/password\"", "Generate a 20-character password": "curl \"https://nordapi.ee/api/v1/generate/password?length=20\"", "Generate a 32-character password": "curl \"https://nordapi.ee/api/v1/generate/password?length=32\"" } } }, "/api/v1/estonian-roads/cameras": { "get": { "description": "All 182 road cameras across Estonia with live image URLs, road surface temperature, air temperature, road condition (DRY, MOIST, WET, ICY), timestamps, and AI-estimated calibration data (pitch, roll, FOV, compass heading, sky visibility percentage). From the Transport Administration (Transpordiamet) TarkTee system.", "operationId": "estonia_ee_road_cameras", "parameters": [ { "description": "Max results (up to 500)", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Road Cameras", "tags": [ "estonia", "baltic", "cameras", "transport", "realtime", "transpordiamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-roads/cameras", "x-examples": {} } }, "/api/v1/colors/scheme/{hex}": { "get": { "description": "Generate a harmonious color palette from any starting hex color. Supports multiple color theory modes: analogic, complement, monochrome, triad, quad, and more. Returns a configurable number of colors (default 5), each with hex, RGB, and HSL values. Useful for design tools, theme generators, brand color exploration, and any creative application that needs to derive related colors from a base color.", "operationId": "tools_colors_scheme", "parameters": [ { "description": "Hex color", "in": "query", "name": "hex", "required": true, "schema": { "type": "string" } }, { "description": "Mode", "in": "query", "name": "mode", "required": false, "schema": { "default": "analogic", "type": "string" } }, { "description": "Colors", "in": "query", "name": "count", "required": false, "schema": { "default": "5", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Color Palette", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/colors/scheme/4287f5?mode=analogic\"", "x-examples": { "Analogic palette from blue": "curl \"https://nordapi.ee/api/v1/colors/scheme/4287f5?mode=analogic\"", "Complementary colors from red": "curl \"https://nordapi.ee/api/v1/colors/scheme/ff0000?mode=complement\"", "Monochrome palette with 8 colors": "curl \"https://nordapi.ee/api/v1/colors/scheme/2ecc71?mode=monochrome&count=8\"", "Triad palette from purple": "curl \"https://nordapi.ee/api/v1/colors/scheme/9b59b6?mode=triad\"" } } }, "/api/v1/history/date/{date}": { "get": { "description": "Access the deep historical exchange rate archive with data going back to January 1999, sourced from the European Central Bank. Retrieve rates for any single date in the archive by providing it in the URL path. Supports base currency and symbol filtering. Ideal for academic research, long-term trend analysis, historical financial reporting, and apps that need exchange rates from specific past events.", "operationId": "finance_history_date", "parameters": [ { "description": "Date in URL (YYYY-MM-DD)", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } }, { "description": "Base currency", "in": "query", "name": "base", "required": false, "schema": { "type": "string" } }, { "description": "Target currencies", "in": "query", "name": "symbols", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Historical Archive (Date)", "tags": [ "finance", "global", "snapshot-history", "ecb", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/history/date/2008-09-15?base=USD&symbols=EUR,GBP\"", "x-examples": { "Brexit vote day rates": "curl \"https://nordapi.ee/api/v1/history/date/2016-06-24?base=GBP\"", "COVID crash rates in Nordic currencies": "curl \"https://nordapi.ee/api/v1/history/date/2020-03-12?base=EUR&symbols=NOK,SEK,DKK\"", "Lehman Brothers collapse day rates": "curl \"https://nordapi.ee/api/v1/history/date/2008-09-15?base=USD&symbols=EUR,GBP\"" } } }, "/api/v1/estonian-cemeteries/search": { "get": { "description": "Search cemeteries by name across all of Estonia.", "operationId": "estonia_ee_cemeteries_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Cemeteries", "tags": [ "estonia", "baltic", "heritage", "search", "kalmistud", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-cemeteries/search?q=Metsa\"", "x-examples": {} } }, "/api/v1/names/nationality/{name}": { "get": { "description": "Predict the most likely nationalities associated with a first name, ranked by probability. Returns a list of country codes with confidence scores. Different names are more common in different countries, so this can help identify the likely cultural background of a name. Useful for localization decisions, cultural personalization, genealogy tools, and demographic research. Data from Nationalize.io.", "operationId": "world_names_nationality", "parameters": [ { "description": "First name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Predict Nationality from Name", "tags": [ "world", "global", "reference", "statistics", "lookup", "nationalize", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/names/nationality/erik", "x-examples": { "Predict nationality for Erik": "curl https://nordapi.ee/api/v1/names/nationality/erik", "Predict nationality for Hiroshi": "curl https://nordapi.ee/api/v1/names/nationality/hiroshi", "Predict nationality for Pierre": "curl https://nordapi.ee/api/v1/names/nationality/pierre" } } }, "/api/v1/estonian-weather/observations": { "get": { "description": "Real-time weather observations from all Estonian weather stations operated by the Estonian Weather Service (Ilmateenistus). Returns temperature, humidity, wind, air pressure, visibility, precipitation, UV index, and water data for ~30 stations across Estonia.", "operationId": "estonia_ee_weather_observations", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Weather Observations", "tags": [ "estonia", "baltic", "weather", "realtime", "ilmateenistus", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-weather/observations", "x-examples": {} } }, "/api/v1/estonian-health/covid/hospitalization": { "get": { "description": "COVID-19 hospitalization data by age group and bed profile. Weekly statistics from Estonia's health system.", "operationId": "estonia_ee_covid_hospitalization", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } }, { "description": "Offset for pagination", "in": "query", "name": "offset", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian COVID Hospitalization", "tags": [ "estonia", "baltic", "health", "lookup", "tehik", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-health/covid/hospitalization?limit=10\"", "x-examples": {} } }, "/api/v1/commodities/{commodity}": { "get": { "description": "Get the current price for a specific commodity (gold, silver, platinum, palladium, oil, natural_gas, or copper) in any of the 30 supported currencies. Returns both the USD base price and the converted price. Useful when you need just one commodity's price rather than the full list, such as displaying the gold price in NOK on a Nordic investment page.", "operationId": "finance_commodity_show", "parameters": [ { "description": "Commodity name in URL", "in": "query", "name": "commodity", "required": true, "schema": { "type": "string" } }, { "description": "Price currency", "in": "query", "name": "currency", "required": false, "schema": { "default": "USD", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Commodity Price", "tags": [ "finance", "global", "commodities", "realtime", "frankfurter", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/commodities/gold?currency=NOK\"", "x-examples": { "Crude oil price in USD": "curl \"https://nordapi.ee/api/v1/commodities/oil\"", "Gold price in NOK": "curl \"https://nordapi.ee/api/v1/commodities/gold?currency=NOK\"", "Silver price in EUR": "curl \"https://nordapi.ee/api/v1/commodities/silver?currency=EUR\"" } } }, "/api/v1/breweries/search": { "get": { "description": "Search for breweries by name across the Open Brewery DB database of 8,000+ breweries worldwide. Returns brewery names, types (micro, nano, brewpub, regional, large, planning, contract), addresses, cities, states, countries, phone numbers, and website URLs. Useful for brewery finder apps, craft beer tourism tools, and local discovery platforms.", "operationId": "food_breweries_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Brewery Search", "tags": [ "food", "global", "drinks", "business", "search", "breweries", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/breweries/search?q=craft\"", "x-examples": { "Search for IPA breweries": "curl \"https://nordapi.ee/api/v1/breweries/search?q=ipa\"", "Search for craft breweries": "curl \"https://nordapi.ee/api/v1/breweries/search?q=craft\"", "Search for microbreweries": "curl \"https://nordapi.ee/api/v1/breweries/search?q=micro\"" } } }, "/api/v1/countrydata/region/{region}": { "get": { "description": "Get all countries within a geographic region (e.g., Europe, Asia, Africa, Americas, Oceania). Returns full country profiles for each nation in the region. Useful for building region-filtered views, geographic analysis tools, and educational apps that explore the world by continent.", "operationId": "geo_countrydata_region", "parameters": [ { "description": "Region name", "in": "query", "name": "region", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Countries by Region", "tags": [ "geo", "global", "geography", "reference", "lookup", "rest-countries", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/countrydata/region/europe", "x-examples": { "All African countries": "curl https://nordapi.ee/api/v1/countrydata/region/africa", "All Asian countries": "curl https://nordapi.ee/api/v1/countrydata/region/asia", "All European countries": "curl https://nordapi.ee/api/v1/countrydata/region/europe" } } }, "/api/v1/arbitrage": { "get": { "description": "Scan for triangular arbitrage opportunities across a set of currencies. Triangular arbitrage exploits pricing inconsistencies when converting through three currencies (e.g., USD->EUR->GBP->USD) yields more than the starting amount. Returns any detected opportunities with the currency path and profit percentage. Educational tool for understanding FX markets, and useful for fintech apps demonstrating market efficiency concepts.", "operationId": "finance_arbitrage", "parameters": [ { "description": "Comma-separated currencies", "in": "query", "name": "currencies", "required": false, "schema": { "default": "USD,EUR,GBP,JPY,CHF,CAD,AUD", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Arbitrage Detection", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/arbitrage?currencies=USD,EUR,GBP,JPY,NOK\"", "x-examples": { "Scan Nordic and European currencies": "curl \"https://nordapi.ee/api/v1/arbitrage?currencies=NOK,SEK,DKK,EUR,CHF,GBP\"", "Scan major currencies for arbitrage": "curl \"https://nordapi.ee/api/v1/arbitrage?currencies=USD,EUR,GBP,JPY,NOK\"", "Scan with default currency set": "curl \"https://nordapi.ee/api/v1/arbitrage\"" } } }, "/api/v1/memes/search": { "get": { "description": "Search for meme templates by name or keyword. Returns matching meme templates with IDs, names, and blank image URLs. Supports partial matching so you can search for 'drake', 'distracted', 'brain', or 'button' to find the right template. Useful for meme creation tools, chat bots with meme capabilities, and social apps that let users quickly find and share specific meme formats.", "operationId": "entertainment_memes_search", "parameters": [ { "description": "Search query (meme name or keyword)", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Meme Search", "tags": [ "entertainment", "global", "search", "imgflip", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/memes/search?q=drake\"", "x-examples": { "Search for Drake meme": "curl \"https://nordapi.ee/api/v1/memes/search?q=drake\"", "Search for brain memes": "curl \"https://nordapi.ee/api/v1/memes/search?q=brain\"", "Search for button memes": "curl \"https://nordapi.ee/api/v1/memes/search?q=button\"" } } }, "/api/v1/economics/rankings/{indicator}": { "get": { "description": "Rank countries worldwide by any economic indicator, from GDP per capita to inflation rate to unemployment. Returns ranked results with country codes and values, configurable up to 50 results. Perfect for building global leaderboard visualizations, identifying top-performing economies, and creating educational content about where countries stand on key economic metrics.", "operationId": "finance_economics_rankings", "parameters": [ { "description": "Indicator key", "in": "query", "name": "indicator", "required": true, "schema": { "type": "string" } }, { "description": "Number of results", "in": "path", "name": "limit", "required": true, "schema": { "default": "50", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Global Rankings", "tags": [ "finance", "global", "reference", "computed", "world-bank", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/economics/rankings/gdp_per_capita?limit=10\"", "x-examples": { "Top 10 countries by GDP per capita": "curl \"https://nordapi.ee/api/v1/economics/rankings/gdp_per_capita?limit=10\"", "Top 20 countries by lowest unemployment": "curl \"https://nordapi.ee/api/v1/economics/rankings/unemployment?limit=20\"", "Top 50 by GDP (default limit)": "curl \"https://nordapi.ee/api/v1/economics/rankings/gdp\"" } } }, "/api/v1/estonian-qualifications/fields": { "get": { "description": "List qualification fields of study.", "operationId": "estonia_ee_qual_fields", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Qualification Fields", "tags": [ "estonia", "baltic", "education", "reference", "lookup", "kutseregister", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-qualifications/fields", "x-examples": {} } }, "/api/v1/placeholder/list": { "get": { "description": "Browse the Lorem Picsum image catalog with author credits and download URLs. Paginated list of curated, high-quality photographs available as placeholders. Each image includes the photographer's name and original source.", "operationId": "tools_placeholder_list", "parameters": [ { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "1", "type": "string" } }, { "description": "Images per page (max 100)", "in": "path", "name": "limit", "required": true, "schema": { "default": "20", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Browse Placeholder Images", "tags": [ "tools", "global", "lookup", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/placeholder/list?page=1&limit=10\"", "x-examples": { "First 20 images": "curl https://nordapi.ee/api/v1/placeholder/list", "Page 3, 50 per page": "curl \"https://nordapi.ee/api/v1/placeholder/list?page=3&limit=50\"" } } }, "/api/v1/hash/all": { "get": { "description": "Generate hashes of an input string using ALL supported algorithms at once (MD5, SHA-1, SHA-256, SHA-384, SHA-512). Returns all five hashes in a single response. Useful for comparing algorithm outputs or generating multiple checksums simultaneously.", "operationId": "tools_hash_all", "parameters": [ { "description": "String to hash", "in": "query", "name": "input", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Hash All Algorithms", "tags": [ "tools", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/hash/all?input=hello+world\"", "x-examples": { "Hash a simple string": "curl \"https://nordapi.ee/api/v1/hash/all?input=hello+world\"", "Hash an email address": "curl \"https://nordapi.ee/api/v1/hash/all?input=user@example.com\"" } } }, "/api/v1/estonian-power/outages": { "get": { "description": "Real-time power outage data from Elektrilevi (rikkekaart.elektrilevi.ee). Shows current and planned outages with affected areas, customer counts, and estimated restoration times.", "operationId": "estonia_ee_power_outages", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Power Outages", "tags": [ "estonia", "baltic", "power", "realtime", "elektrilevi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-power/outages", "x-examples": {} } }, "/api/v1/estonian-sports/facilities": { "get": { "description": "4,161 sports facilities from the Estonian Sports Register (spordiregister.ee). Filter by municipality or search by name.", "operationId": "estonia_ee_sports_facilities", "parameters": [ { "description": "Filter by municipality name", "in": "query", "name": "municipality", "required": false, "schema": { "type": "string" } }, { "description": "Search by name", "in": "query", "name": "q", "required": false, "schema": { "type": "string" } }, { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Sports Facilities", "tags": [ "estonia", "baltic", "sports", "search", "spordiregister", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-sports/facilities?municipality=Tallinn&limit=10\"", "x-examples": {} } }, "/api/v1/estonian-mtr/transport": { "get": { "description": "List transport-related business licenses.", "operationId": "estonia_ee_mtr_transport", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Transport Licenses", "tags": [ "estonia", "baltic", "business", "transport", "legal", "lookup", "mtr-ttja", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-mtr/transport", "x-examples": {} } }, "/api/v1/matrix": { "get": { "description": "Generate a full NxN cross-rate table for any selection of currencies. Every currency is shown against every other currency in a single response, like the exchange rate boards at airports. Useful for forex comparison tables, travel apps showing multiple currency pairs, and financial dashboards that need to display all possible combinations at once.", "operationId": "finance_matrix", "parameters": [ { "description": "Comma-separated codes (e.g. USD,EUR,GBP,NOK)", "in": "query", "name": "currencies", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cross-Rate Matrix", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/matrix?currencies=USD,EUR,GBP,NOK\"", "x-examples": { "Major world currencies cross-rates": "curl \"https://nordapi.ee/api/v1/matrix?currencies=USD,EUR,GBP,JPY\"", "Nordic currencies cross-rates": "curl \"https://nordapi.ee/api/v1/matrix?currencies=NOK,SEK,DKK,EUR\"", "Travel currencies for Asia trip": "curl \"https://nordapi.ee/api/v1/matrix?currencies=USD,JPY,CNY,THB,INR\"" } } }, "/api/v1/harrypotter/staff": { "get": { "description": "Get all Hogwarts staff members from the Harry Potter universe, including professors, caretakers, and other school employees. Returns name, house (if applicable), ancestry, patronus, actor, and wand details. Useful for faculty directory features, professor quiz apps, and Hogwarts-themed educational tools. Data from the HP-API.", "operationId": "entertainment_harrypotter_staff", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Hogwarts Staff", "tags": [ "entertainment", "global", "movies", "lookup", "hp-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/harrypotter/staff", "x-examples": { "Browse Hogwarts faculty": "curl https://nordapi.ee/api/v1/harrypotter/staff", "List all Hogwarts staff": "curl https://nordapi.ee/api/v1/harrypotter/staff" } } }, "/api/v1/fun/number/{number}": { "get": { "description": "Get a fun, interesting fact about any number. For example, 42 is 'the number of laws of cricket' or 'the answer to the ultimate question of life, the universe, and everything.' Returns a trivia fact from the Numbers API. Useful for educational math apps, number-of-the-day features, gamification elements, and adding delight to interfaces that display numbers.", "operationId": "entertainment_fun_number", "parameters": [ { "description": "Number", "in": "path", "name": "number", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Number Fact", "tags": [ "entertainment", "global", "reference", "lookup", "numbersapi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/fun/number/42", "x-examples": { "Fact about 1000": "curl https://nordapi.ee/api/v1/fun/number/1000", "Fact about 42": "curl https://nordapi.ee/api/v1/fun/number/42", "Fact about 7": "curl https://nordapi.ee/api/v1/fun/number/7" } } }, "/api/v1/mashup/outdoor/planner": { "get": { "description": "Comprehensive outdoor activity assessment for any location. Combines real-time weather, air quality, elevation, light pollution, nearby seismic activity, marine conditions, and sunrise/sunset into an overall outdoor score with personalized activity suggestions (hiking, cycling, stargazing, etc.).", "operationId": "mashups_outdoor_planner", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Outdoor Activity Planner", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/outdoor/planner?lat=59.91&lon=10.75\"", "x-examples": {} } }, "/api/v1/estonian-auctions": { "get": { "description": "Government property auctions from riigimaaoksjon.ee. Active land and building sales/rentals with cadastral IDs, addresses, prices, and areas.", "operationId": "estonia_ee_auctions", "parameters": [ { "description": "Results per page (max 100)", "in": "path", "name": "limit", "required": true, "schema": { "default": "20", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian State Auctions", "tags": [ "estonia", "baltic", "business", "civic", "lookup", "riigimaaoksjon", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-auctions", "x-examples": {} } }, "/api/v1/barcode/types": { "get": { "description": "List all supported barcode formats for generation, including Code 128, Code 39, EAN-13, EAN-8, UPC-A, QR Code, Data Matrix, and more. Use this to discover which barcode types are available and their characteristics before generating barcodes. Useful for inventory management apps and shipping label generators that need to select the right barcode format.", "operationId": "tools_barcode_types", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Barcode Types", "tags": [ "tools", "global", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/barcode/types", "x-examples": {} } }, "/api/v1/electricity/zones": { "get": { "description": "List all 9 Nordic electricity bidding zones with their codes, names, and countries. Norway has 5 zones (NO1-NO5) and Sweden has 4 zones (SE1-SE4), each with potentially different electricity prices due to grid capacity and local supply/demand. Use this to discover valid zone codes for the other electricity endpoints. Essential reference data for Nordic energy apps and smart home systems.", "operationId": "electricity_zones", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Bidding Zones", "tags": [ "electricity", "global", "nordic", "power", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/electricity/zones", "x-examples": {} } }, "/api/v1/recipes/categories": { "get": { "description": "List all available meal categories (e.g., Beef, Chicken, Seafood, Vegetarian, Dessert, Pasta, etc.) with descriptions and thumbnail images. Use these categories to build filtered recipe browsing experiences and category navigation menus. Data from TheMealDB.", "operationId": "entertainment_recipes_categories", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Meal Categories", "tags": [ "entertainment", "global", "food", "lookup", "themealdb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/recipes/categories", "x-examples": {} } }, "/api/v1/profanity/filter": { "get": { "description": "Filter profanity from text, replacing bad words with asterisks or a custom replacement. Supports adding custom words to filter.", "operationId": "texttools_profanity_filter", "parameters": [ { "description": "Text to filter", "in": "query", "name": "text", "required": true, "schema": { "type": "string" } }, { "description": "Additional words to filter (comma-separated)", "in": "query", "name": "add", "required": false, "schema": { "type": "string" } }, { "description": "Replacement character (default: *)", "in": "query", "name": "fill_char", "required": false, "schema": { "type": "string" } }, { "description": "Replacement text instead of characters", "in": "query", "name": "fill_text", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Profanity Filter", "tags": [ "texttools", "global", "tools", "text", "computed", "purgomalum", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/profanity/filter?text=hello+world\"", "x-examples": {} } }, "/api/v1/carbonintensity/history": { "get": { "description": "Time series of UK grid carbon intensity (forecast + actual + index) with the full generation mix preserved at each 30-minute interval. Stored continuously by our own workers. Filter with ?start and ?end. Useful for long-range decarbonisation analysis, correlating carbon intensity with weather or power prices, and researching the UK grid's transition away from fossil generation.", "operationId": "science_carbonintensity_history", "parameters": [ { "description": "Start datetime", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "UK Carbon Intensity History", "tags": [ "science", "united-kingdom", "europe", "power", "environment", "snapshot-history", "carbonintensity-org-uk", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/carbonintensity/history?limit=48\"", "x-examples": { "A specific month": "curl \"https://nordapi.ee/api/v1/carbonintensity/history?start=2026-03-01&end=2026-03-31&limit=2000\"", "Last 24 hours (48 half-hour periods)": "curl \"https://nordapi.ee/api/v1/carbonintensity/history?limit=48\"" } } }, "/api/v1/estonian-plans/search": { "get": { "description": "Full-text search across 17,420 Estonian spatial plans by name or municipality. Returns plan type, status, established date, and area.", "operationId": "estonia_ee_plans_search", "parameters": [ { "description": "Search query (plan name or municipality)", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Spatial Plans", "tags": [ "estonia", "baltic", "civic", "environment", "search", "plank-planeeringud", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-plans/search?q=Tallinn\"", "x-examples": {} } }, "/api/v1/estonian-mtr/licenses/{category}": { "get": { "description": "List business licenses for a specific activity category.", "operationId": "estonia_ee_mtr_licenses", "parameters": [ { "description": "Category slug", "in": "path", "name": "category", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Business Licenses by Category", "tags": [ "estonia", "baltic", "business", "legal", "lookup", "mtr-ttja", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-mtr/licenses/passenger-transport", "x-examples": {} } }, "/api/v1/economics/compare/{indicator}": { "get": { "description": "Compare a specific economic indicator across multiple countries side by side. Provide the indicator key in the URL and a comma-separated list of country codes as a parameter. Returns the latest value for each country, making it easy to build comparison bar charts, ranking tables, and cross-country economic analysis tools. For example, compare GDP per capita across Norway, USA, Germany, and Estonia.", "operationId": "finance_economics_compare", "parameters": [ { "description": "Indicator key", "in": "query", "name": "indicator", "required": true, "schema": { "type": "string" } }, { "description": "Comma-separated country codes", "in": "query", "name": "countries", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Compare Countries", "tags": [ "finance", "global", "reference", "computed", "world-bank", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/economics/compare/gdp_per_capita?countries=NO,US,DE,EE\"", "x-examples": { "Compare GDP per capita across Nordic and Western countries": "curl \"https://nordapi.ee/api/v1/economics/compare/gdp_per_capita?countries=NO,US,DE,EE\"", "Compare inflation rates in G7 nations": "curl \"https://nordapi.ee/api/v1/economics/compare/inflation?countries=US,GB,DE,FR,JP,CA,IT\"", "Compare unemployment in Nordic countries": "curl \"https://nordapi.ee/api/v1/economics/compare/unemployment?countries=NO,SE,DK,FI\"" } } }, "/api/v1/advice/search": { "get": { "description": "Search for advice containing specific keywords.", "operationId": "texttools_advice_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Advice", "tags": [ "texttools", "global", "text", "reference", "search", "advice-slip", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/advice/search?q=love\"", "x-examples": {} } }, "/api/v1/recipes/random": { "get": { "description": "Get a completely random recipe with full cooking instructions, ingredient list with measurements, category, cuisine origin, and a thumbnail image. Perfect for 'what should I cook tonight?' features, recipe-of-the-day widgets, cooking challenge generators, and adding variety to meal planning apps. Data from TheMealDB.", "operationId": "entertainment_recipes_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Recipe", "tags": [ "entertainment", "global", "food", "computed", "themealdb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/recipes/random", "x-examples": {} } }, "/api/v1/mashup/performance/compare": { "get": { "description": "Compare the performance of different asset classes side by side: cryptocurrencies (Bitcoin, Ethereum, etc.), fiat currencies (relative to USD), and gold. Returns current values, recent price changes, and comparative performance metrics. Useful for investment dashboards that span asset classes, portfolio diversification analysis tools, and financial education platforms that demonstrate how different stores of value perform relative to each other.", "operationId": "mashups_performance", "parameters": [ { "description": "Crypto coins", "in": "query", "name": "crypto", "required": false, "schema": { "type": "string" } }, { "description": "Fiat currencies", "in": "query", "name": "fiat", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Asset Performance", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/performance/compare?crypto=bitcoin,ethereum&fiat=EUR,NOK\"", "x-examples": { "Compare Bitcoin, Ethereum against EUR and NOK": "curl \"https://nordapi.ee/api/v1/mashup/performance/compare?crypto=bitcoin,ethereum&fiat=EUR,NOK\"", "Compare just Bitcoin against major fiat currencies": "curl \"https://nordapi.ee/api/v1/mashup/performance/compare?crypto=bitcoin&fiat=USD,EUR,GBP\"", "Compare top cryptos against Nordic currencies": "curl \"https://nordapi.ee/api/v1/mashup/performance/compare?crypto=bitcoin,ethereum,solana&fiat=NOK,SEK\"" } } }, "/api/v1/tv/search": { "get": { "description": "Search for TV shows by title across a comprehensive database of shows from TVMaze. Returns show names, genres, premiere dates, ratings, network information, and summary descriptions. Useful for building TV guide apps, watchlist features, show recommendation engines, and entertainment discovery platforms.", "operationId": "entertainment_tv_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "TV Show Search", "tags": [ "entertainment", "global", "tv", "search", "tvmaze", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/tv/search?q=breaking+bad\"", "x-examples": { "Search for Breaking Bad": "curl \"https://nordapi.ee/api/v1/tv/search?q=breaking+bad\"", "Search for The Office": "curl \"https://nordapi.ee/api/v1/tv/search?q=the+office\"", "Search for sci-fi shows": "curl \"https://nordapi.ee/api/v1/tv/search?q=stranger+things\"" } } }, "/api/v1/sports": { "get": { "description": "List all available sports and their leagues that have live score data. Returns sport names and league identifiers that you can use with the live scores endpoint. Covers major sports including soccer (Premier League, La Liga, Serie A, Bundesliga), American football (NFL), basketball (NBA), baseball (MLB), hockey (NHL), and more. Data sourced from ESPN.", "operationId": "entertainment_sports", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Available Sports", "tags": [ "entertainment", "global", "sports", "lookup", "espn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/sports", "x-examples": {} } }, "/api/v1/music/charts": { "get": { "description": "Get the current top tracks chart from Deezer, showing the most popular songs right now with track titles, artist names, album details, preview URLs, and ranking positions. Useful for building music chart displays, trending music features, and playlist generation tools that leverage current popularity data.", "operationId": "entertainment_music_charts", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Music Charts", "tags": [ "entertainment", "global", "music", "realtime", "deezer", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/music/charts", "x-examples": {} } }, "/api/v1/tallinn/data/building-permits": { "get": { "description": "Building permits issued in Tallinn.", "operationId": "estonia_tallinn_building_permits", "parameters": [ { "description": "Results per page", "in": "query", "name": "per_page", "required": false, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Building Permits", "tags": [ "estonia", "baltic", "civic", "lookup", "avaandmed-tallinn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/data/building-permits", "x-examples": {} } }, "/api/v1/radio/country/{country}": { "get": { "description": "Get all internet radio stations broadcasting from a specific country. Returns station names, stream URLs, genres, bitrates, and codec information. Useful for building country-specific radio directories, helping expatriates find stations from their home country, and exploring the radio landscape of any nation. Data from Radio Browser.", "operationId": "entertainment_radio_country", "parameters": [ { "description": "Country name", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Stations by Country", "tags": [ "entertainment", "global", "music", "lookup", "radio-browser", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/radio/country/Norway", "x-examples": { "Brazilian radio stations": "curl https://nordapi.ee/api/v1/radio/country/Brazil", "Japanese radio stations": "curl https://nordapi.ee/api/v1/radio/country/Japan", "Norwegian radio stations": "curl https://nordapi.ee/api/v1/radio/country/Norway" } } }, "/api/v1/weather/forecast": { "get": { "description": "Get a multi-day weather forecast for up to 16 days, with daily high/low temperatures, precipitation probability, wind speed, and weather codes. Supports coordinates or city name lookup. Useful for travel planning apps, event scheduling tools, agriculture dashboards, and any feature that helps users plan around future weather conditions. Data from Open-Meteo forecast models.", "operationId": "geo_weather_forecast", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": false, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": false, "schema": { "type": "string" } }, { "description": "City name", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } }, { "description": "Forecast days", "in": "query", "name": "days", "required": false, "schema": { "default": "7", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Weather Forecast", "tags": [ "geo", "global", "weather", "realtime", "open-meteo", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/weather/forecast?city=tokyo&days=7\"", "x-examples": { "16-day forecast by coordinates (Sydney)": "curl \"https://nordapi.ee/api/v1/weather/forecast?lat=-33.87&lon=151.21&days=16\"", "3-day forecast for London": "curl \"https://nordapi.ee/api/v1/weather/forecast?city=london&days=3\"", "7-day forecast for Tokyo": "curl \"https://nordapi.ee/api/v1/weather/forecast?city=tokyo&days=7\"", "Default forecast for Oslo": "curl \"https://nordapi.ee/api/v1/weather/forecast?city=oslo\"" } } }, "/api/v1/estonian-auctions/organizations": { "get": { "description": "List all government organizations that manage state property auctions on riigimaaoksjon.ee. Includes Riigi Kinnisvara AS and other state asset managers.", "operationId": "estonia_ee_auctions_orgs", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Auction Organizations", "tags": [ "estonia", "baltic", "business", "civic", "lookup", "riigimaaoksjon", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-auctions/organizations", "x-examples": {} } }, "/api/v1/fun/fact": { "get": { "description": "Get a random fun, surprising, or bizarre fact from a large collection of 'useless' but entertaining trivia. Examples: 'Honey never spoils' or 'An octopus has three hearts.' Perfect for chatbot conversation starters, daily notification features, loading screen entertainment, ice-breaker generators, and any app that benefits from moments of delightful surprise.", "operationId": "entertainment_fun_fact", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Fact", "tags": [ "entertainment", "global", "computed", "uselessfacts", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/fun/fact", "x-examples": {} } }, "/api/v1/geocoding/search": { "get": { "description": "Convert place names, addresses, or location descriptions into geographic coordinates (latitude and longitude). Returns matching locations with their names, countries, coordinates, elevation, population, and timezone. Supports fuzzy matching and returns multiple results ranked by relevance. Data from Open-Meteo geocoding powered by the GeoNames database. Essential for any app that needs to convert user-typed locations into coordinates for use with weather, map, or other location-based APIs.", "operationId": "geo_geocoding_search", "parameters": [ { "description": "Place name or address to search", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } }, { "description": "Number of results (max 50)", "in": "query", "name": "count", "required": false, "schema": { "default": "10", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Geocoding Search", "tags": [ "geo", "global", "geography", "search", "open-meteo", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/geocoding/search?q=Oslo\"", "x-examples": { "Search for New York with more results": "curl \"https://nordapi.ee/api/v1/geocoding/search?q=New+York&count=20\"", "Search for Oslo": "curl \"https://nordapi.ee/api/v1/geocoding/search?q=Oslo\"", "Search for Tokyo": "curl \"https://nordapi.ee/api/v1/geocoding/search?q=Tokyo\"" } } }, "/api/v1/curated/datasets/{id}": { "get": { "description": "Get a specific curated dataset by ID.", "operationId": "estonia_ee_curated_dataset", "parameters": [ { "description": "Dataset ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Curated Dataset Detail", "tags": [ "estonia", "baltic", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/curated/datasets/estonian_cemeteries", "x-examples": {} } }, "/api/v1/music/search": { "get": { "description": "Search for songs and artists across the Deezer music catalog. Filter by type (tracks or artists) to narrow results. Returns track titles, artist names, album info, preview URLs, and cover art links. Useful for music discovery apps, playlist builders, artist lookup tools, and any feature that needs to search a large music database.", "operationId": "entertainment_music_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } }, { "description": "tracks or artists", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Music Search", "tags": [ "entertainment", "global", "music", "search", "deezer", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/music/search?q=Beatles\"", "x-examples": { "Search for Beatles songs": "curl \"https://nordapi.ee/api/v1/music/search?q=Beatles\"", "Search for artists named Adele": "curl \"https://nordapi.ee/api/v1/music/search?q=Adele&type=artists\"", "Search for tracks by keyword": "curl \"https://nordapi.ee/api/v1/music/search?q=bohemian+rhapsody&type=tracks\"" } } }, "/api/v1/tallinn/transport/departures/{stop_id}": { "get": { "description": "Next departures from a Tallinn public transport stop. Returns expected and scheduled arrival times for each route serving the stop. Uses the SIRI protocol from Tallinn Transport.", "operationId": "estonia_tallinn_departures", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Stop Departures", "tags": [ "estonia", "baltic", "transport", "civic", "realtime", "tlt", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/transport/departures/3742", "x-examples": {} } }, "/api/v1/history/significant": { "get": { "description": "Get a curated list of historically significant dates in financial history - events like the Lehman Brothers collapse (2008-09-15), the Brexit vote (2016-06-24), the COVID crash (2020-03-12), and more - each paired with exchange rate data from that date. Useful for educational apps, financial history timelines, and demonstrating how major world events impact currency markets.", "operationId": "finance_history_significant", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Significant Dates in Forex History", "tags": [ "finance", "global", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/history/significant", "x-examples": {} } }, "/api/v1/elering/system": { "get": { "description": "Real-time status of the Estonian power grid from Elering (Estonian TSO). Returns current production, consumption, grid frequency, system balance, AC balance, and renewable energy production in MW.", "operationId": "estonia_elering_system", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Power Grid Status", "tags": [ "estonia", "baltic", "power", "realtime", "elering", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/elering/system", "x-examples": {} } }, "/api/v1/cards/draw/{deck_id}": { "get": { "description": "Draw cards from a previously created deck. Returns card images, values, and suits.", "operationId": "gaming_cards_draw", "parameters": [ { "description": "Number of cards to draw", "in": "query", "name": "count", "required": false, "schema": { "default": "1", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Draw Cards", "tags": [ "gaming", "global", "games", "computed", "deck-of-cards", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/cards/draw/abc123?count=5\"", "x-examples": {} } }, "/api/v1/holidays/{country_code}": { "get": { "description": "Get all public holidays for a specific country in the current year. A convenient shortcut that does not require specifying the year. Returns holiday names, dates, and types. Ideal for quick lookups and dashboard widgets that display this year's remaining holidays for a given country.", "operationId": "world_holidays_index", "parameters": [ { "description": "Country code", "in": "query", "name": "country_code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Country Holidays", "tags": [ "world", "global", "reference", "time", "lookup", "nager-date", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/holidays/NO", "x-examples": { "Germany holidays this year": "curl https://nordapi.ee/api/v1/holidays/DE", "Norway holidays this year": "curl https://nordapi.ee/api/v1/holidays/NO", "UK holidays this year": "curl https://nordapi.ee/api/v1/holidays/GB" } } }, "/api/v1/games/free": { "get": { "description": "Browse 1,000+ free-to-play games with filters for platform and genre. Returns title, thumbnail, description, genre, platform, publisher, developer, and release date.", "operationId": "gaming_free_games", "parameters": [ { "description": "Filter: pc, browser, or all", "in": "query", "name": "platform", "required": false, "schema": { "type": "string" } }, { "description": "Genre: mmorpg, shooter, strategy, moba, racing, sports, battle-royale, etc.", "in": "path", "name": "category", "required": true, "schema": { "type": "string" } }, { "description": "Sort: release-date, popularity, alphabetical, relevance", "in": "query", "name": "sort-by", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Free-to-Play Games", "tags": [ "gaming", "global", "games", "search", "free-to-game", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/games/free?platform=pc&category=shooter&sort-by=popularity\"", "x-examples": {} } }, "/api/v1/dnd/monsters": { "get": { "description": "Browse all monsters from the Dungeons & Dragons 5th Edition System Reference Document. Returns a paginated list of monster names and index keys. Data from the open D&D 5e API covering hundreds of creatures from the official SRD, including classic foes like dragons, beholders, and owlbears. Useful for dungeon master prep tools, encounter builders, tabletop RPG companion apps, and fantasy game reference databases.", "operationId": "entertainment_dnd_monsters", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "D&D Monster List", "tags": [ "entertainment", "global", "games", "lookup", "dnd5e-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/dnd/monsters", "x-examples": { "Browse the monster compendium": "curl https://nordapi.ee/api/v1/dnd/monsters", "List all D&D monsters": "curl https://nordapi.ee/api/v1/dnd/monsters" } } }, "/api/v1/radio/search": { "get": { "description": "Search across 45,000+ internet radio stations worldwide by station name, country, or genre tag. Returns stream URLs, station names, bitrate, codec, country, and genre tags. Data from the community-driven Radio Browser API. Useful for building internet radio apps, discovering local stations abroad, and creating genre-specific streaming playlists.", "operationId": "entertainment_radio_search", "parameters": [ { "description": "Station name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } }, { "description": "Country", "in": "query", "name": "country", "required": false, "schema": { "type": "string" } }, { "description": "Genre tag", "in": "query", "name": "tag", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Radio Search", "tags": [ "entertainment", "global", "music", "search", "radio-browser", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/radio/search?name=jazz&country=Norway\"", "x-examples": { "Classical music stations in Germany": "curl \"https://nordapi.ee/api/v1/radio/search?tag=classical&country=Germany\"", "Jazz stations in Norway": "curl \"https://nordapi.ee/api/v1/radio/search?name=jazz&country=Norway\"", "Rock stations worldwide": "curl \"https://nordapi.ee/api/v1/radio/search?tag=rock\"" } } }, "/api/v1/vehicles/makes": { "get": { "description": "Get a complete list of all vehicle manufacturers from the NHTSA database.", "operationId": "geography_vehicle_makes", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Vehicle Makes", "tags": [ "geography", "united-states", "americas", "vehicles", "transport", "lookup", "nhtsa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/vehicles/makes", "x-examples": {} } }, "/api/v1/estonian-power/outages/events": { "get": { "description": "Lifecycle view of Elektrilevi outages: one row per distinct outage, with first_seen_at, last_seen_at, resolved_at, duration_seconds, and peak customers affected. Filter by ?status=active|resolved and ?start/?end. Useful for MTTR analytics, incident counts by cause, and studying how fast the grid recovers from storms and faults.", "operationId": "estonia_ee_power_outages_events", "parameters": [ { "description": "active or resolved", "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "description": "Start datetime (first_seen_at)", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime (first_seen_at)", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Power Outage Events", "tags": [ "estonia", "baltic", "power", "snapshot-history", "elektrilevi", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-power/outages/events?status=resolved&limit=100\"", "x-examples": {} } }, "/api/v1/estonian-plans": { "get": { "description": "17,420 established spatial plans from planeeringud.ee (PLANK). Includes detailed plans, comprehensive plans, and county plans. System is read-only since Dec 2025.", "operationId": "estonia_ee_plans", "parameters": [ { "description": "Plan type: MP (county), MPJ (detailed), or MPTP (thematic)", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } }, { "description": "Filter by organizing body (e.g. Tallinn)", "in": "query", "name": "organizer", "required": false, "schema": { "type": "string" } }, { "description": "Filter by status (e.g. kehtiv = active)", "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "description": "Results per page (max 200)", "in": "path", "name": "limit", "required": true, "schema": { "default": "50", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Spatial Plans", "tags": [ "estonia", "baltic", "civic", "environment", "lookup", "plank-planeeringud", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-plans", "x-examples": {} } }, "/api/v1/riigiteataja/{eli_id}": { "get": { "description": "Get details of a specific Estonian law by its ELI (European Legislation Identifier) ID. Returns the law title, ELI ID, and link to the full text on Riigi Teataja.", "operationId": "estonia_riigiteataja_law", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Law by ELI ID", "tags": [ "estonia", "baltic", "legal", "lookup", "riigi-teataja", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/riigiteataja/521052015001", "x-examples": {} } }, "/api/v1/estonian-utilities": { "get": { "description": "All Estonian utility rates in one response: water (Tallinna Vesi), district heating (Utilitas), electricity network fees (Elektrilevi), natural gas, and waste collection. Includes regulated prices, service providers, and links to official sources. Prices are approved by the Competition Authority (Konkurentsiamet).", "operationId": "estonia_ee_utilities", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Utility Rates", "tags": [ "estonia", "baltic", "power", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-utilities", "x-examples": {} } }, "/api/v1/mashup/games/deals": { "get": { "description": "Find the best digital game deals with automatic currency conversion. Combines CheapShark deal data across Steam, GOG, and Humble Bundle with real-time forex rates to show prices in your local currency. Filter by maximum price in your currency.", "operationId": "mashups_game_deals_global", "parameters": [ { "description": "Target currency code (e.g. EUR, GBP, NOK)", "in": "query", "name": "currency", "required": false, "schema": { "default": "USD", "type": "string" } }, { "description": "Maximum price in target currency", "in": "query", "name": "max_price", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Global Game Deals", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/games/deals?currency=EUR&max_price=10\"", "x-examples": {} } }, "/api/v1/bikes/networks": { "get": { "description": "Get a list of all bike-sharing networks worldwide from the CityBikes API, covering 600+ cities across the globe. Returns network names, cities, countries, and network IDs. Useful for building urban mobility apps, bike-sharing aggregators, sustainable transportation dashboards, and city comparison tools that evaluate cycling infrastructure.", "operationId": "tools_bikes_networks", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Bike Sharing Networks", "tags": [ "tools", "global", "transport", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/bikes/networks", "x-examples": {} } }, "/api/v1/estonian-ports": { "get": { "description": "All 248 Estonian ports and harbors from sadamaregister.ee with GPS coordinates, services, vessel specs, and navigation periods. Filter by type or water body.", "operationId": "estonia_ee_ports", "parameters": [ { "description": "Filter: port, small port, fishing port, yacht harbor", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } }, { "description": "Filter: Baltic, Gulf of Finland, Peipsi", "in": "query", "name": "water_body", "required": false, "schema": { "type": "string" } }, { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Ports", "tags": [ "estonia", "baltic", "transport", "travel", "lookup", "sadamaregister", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-ports?limit=10\"", "x-examples": {} } }, "/api/v1/flights/live": { "get": { "description": "Get real-time positions of aircraft currently in flight worldwide from the OpenSky Network ADS-B data. Returns callsign, origin country, longitude, latitude, altitude, velocity, and heading for each aircraft. Optionally filter by a geographic bounding box to track flights over a specific area. Useful for flight tracking apps, aviation dashboards, noise monitoring near airports, and visualizing air traffic patterns.", "operationId": "geo_flights_live", "parameters": [ { "description": "Bounding box south", "in": "query", "name": "lamin", "required": false, "schema": { "type": "string" } }, { "description": "West", "in": "query", "name": "lomin", "required": false, "schema": { "type": "string" } }, { "description": "North", "in": "query", "name": "lamax", "required": false, "schema": { "type": "string" } }, { "description": "East", "in": "query", "name": "lomax", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Live Flight Tracking", "tags": [ "geo", "global", "transport", "realtime", "opensky", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/flights/live", "x-examples": { "All flights worldwide": "curl https://nordapi.ee/api/v1/flights/live", "Flights over Scandinavia": "curl \"https://nordapi.ee/api/v1/flights/live?lamin=55&lomin=5&lamax=72&lomax=30\"", "Flights over the New York area": "curl \"https://nordapi.ee/api/v1/flights/live?lamin=40&lomin=-75&lamax=41.5&lomax=-73\"" } } }, "/api/v1/estonian-mtr/categories": { "get": { "description": "List 27 economic activity domains from the Estonian MTR register (mtr.ttja.ee).", "operationId": "estonia_ee_mtr_categories", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Economic Activity Domains", "tags": [ "estonia", "baltic", "business", "legal", "lookup", "mtr-ttja", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-mtr/categories", "x-examples": {} } }, "/api/v1/estonian-plans/types": { "get": { "description": "List all types of spatial plans in Estonia with counts. Includes detailplaneering (detailed plans), üldplaneering (comprehensive plans), and maakonnaplaneering (county plans).", "operationId": "estonia_ee_plans_types", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Spatial Plan Types", "tags": [ "estonia", "baltic", "civic", "environment", "lookup", "plank-planeeringud", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-plans/types", "x-examples": {} } }, "/api/v1/tallinn/parking-zones/nearby": { "get": { "description": "Find parking zones within a radius of a GPS coordinate. Returns zones sorted by distance with polygon boundaries, opening hours, and addresses. Useful for parking apps and navigation.", "operationId": "estonia_tln_parking_zones_nearby", "parameters": [ { "description": "Latitude (e.g. 59.437)", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude (e.g. 24.745)", "in": "query", "name": "lng", "required": true, "schema": { "type": "string" } }, { "description": "Search radius in km (default 1.0)", "in": "query", "name": "radius", "required": false, "schema": { "default": "1.0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Nearby Parking Zones", "tags": [ "estonia", "baltic", "transport", "civic", "lookup", "parkimine", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/tallinn/parking-zones/nearby?lat=59.437&lng=24.745\"", "x-examples": {} } }, "/api/v1/time/ip/{ip}": { "get": { "description": "Get the current time for the location associated with an IP address.", "operationId": "time_time_ip", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Current Time by IP", "tags": [ "time", "global", "timezone", "lookup", "timeapi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/time/ip/8.8.8.8", "x-examples": {} } }, "/api/v1/tallinn/parking-zones": { "get": { "description": "209 parking zones in Tallinn and other Estonian cities from parkimine.ee. Each zone includes GPS coordinates, polygon boundaries, opening hours, and addresses.", "operationId": "estonia_tln_parking_zones", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Parking Zones", "tags": [ "estonia", "baltic", "transport", "civic", "lookup", "parkimine", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/parking-zones", "x-examples": {} } }, "/api/v1/geo/timezone": { "get": { "description": "Look up timezone information by geographic coordinates or timezone name. Returns the timezone identifier (e.g., Europe/Oslo), current local time, UTC offset, and DST status. Useful for scheduling apps that need to display times in a user's local timezone, meeting planners across time zones, and any feature that converts between UTC and local time.", "operationId": "geo_geo_timezone", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": false, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": false, "schema": { "type": "string" } }, { "description": "Timezone name", "in": "path", "name": "zone", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Timezone Lookup", "tags": [ "geo", "global", "geography", "timezone", "lookup", "timeapi", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/geo/timezone?lat=59.9&lon=10.7\"", "x-examples": { "Timezone by name": "curl \"https://nordapi.ee/api/v1/geo/timezone?zone=America/New_York\"", "Timezone for Oslo by coordinates": "curl \"https://nordapi.ee/api/v1/geo/timezone?lat=59.9&lon=10.7\"", "Timezone for Tokyo by coordinates": "curl \"https://nordapi.ee/api/v1/geo/timezone?lat=35.68&lon=139.69\"" } } }, "/api/v1/zipcode/reverse": { "get": { "description": "Find all postal/zip codes for a given city, state, and country. The reverse of a postal code lookup - you provide the location and get back matching postal codes. Useful for generating postal code lists for delivery zone mapping, populating postal code fields from known city names, and building geographic coverage analysis tools.", "operationId": "geo_zipcode_reverse", "parameters": [ { "description": "Country", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } }, { "description": "State", "in": "query", "name": "state", "required": true, "schema": { "type": "string" } }, { "description": "City", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Reverse Postal Lookup", "tags": [ "geo", "global", "geography", "lookup", "zippopotam", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/zipcode/reverse?country=us&state=CA&city=Beverly+Hills\"", "x-examples": { "Postal codes in Berlin, Germany": "curl \"https://nordapi.ee/api/v1/zipcode/reverse?country=de&state=Berlin&city=Berlin\"", "Postal codes in Oslo, Norway": "curl \"https://nordapi.ee/api/v1/zipcode/reverse?country=no&state=Oslo&city=Oslo\"", "Zip codes in Beverly Hills, CA": "curl \"https://nordapi.ee/api/v1/zipcode/reverse?country=us&state=CA&city=Beverly+Hills\"" } } }, "/api/v1/bible/{reference}": { "get": { "description": "Look up any Bible verse or passage by reference. Supports book names with chapter and verse numbers (e.g. 'john 3:16', 'psalm 23:1-6', 'genesis 1:1-10'). Returns full text, translation details, and individual verse breakdowns.", "operationId": "scripture_bible_verse", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Bible Verse Lookup", "tags": [ "scripture", "global", "lookup", "bible-api", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/bible/john+3:16\"", "x-examples": {} } }, "/api/v1/animals/dogs/random": { "get": { "description": "Get a random dog image URL. Every call returns a different adorable dog photo. Perfect for mood-boosting app features, placeholder images during loading states, pet-themed social media tools, and 'daily dog' widgets. Images sourced from the Dog CEO API's community-contributed collection of thousands of dog photos.", "operationId": "entertainment_dogs_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Dog", "tags": [ "entertainment", "global", "computed", "dog-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/animals/dogs/random", "x-examples": {} } }, "/api/v1/electricity/current/{zone}": { "get": { "description": "Get the current hour's electricity spot price for a specific Nordic bidding zone (e.g., NO1 for Oslo area, SE3 for Stockholm area). Returns the price in EUR/MWh along with the current hour period. Essential for smart home automation that adjusts heating, EV charging, or appliance usage based on real-time electricity cost. Also useful for energy cost monitoring dashboards and price alert systems. Data from Nord Pool.", "operationId": "electricity_current", "parameters": [ { "description": "Zone code (NO1, SE3, etc)", "in": "path", "name": "zone", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Current Price", "tags": [ "electricity", "global", "nordic", "power", "realtime", "hvakosterstrommen", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/electricity/current/NO1", "x-examples": { "Current price in Bergen area (NO5)": "curl https://nordapi.ee/api/v1/electricity/current/NO5", "Current price in Oslo area (NO1)": "curl https://nordapi.ee/api/v1/electricity/current/NO1", "Current price in Stockholm area (SE3)": "curl https://nordapi.ee/api/v1/electricity/current/SE3" } } }, "/api/v1/cocktails/ingredients": { "get": { "description": "List all available cocktail ingredients in the database (vodka, rum, gin, tequila, various mixers, garnishes, etc.). Use this to build ingredient-based recipe search, 'what can I make with what I have' features, and bar inventory management tools. Data from TheCocktailDB.", "operationId": "entertainment_cocktails_ingredients", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cocktail Ingredients", "tags": [ "entertainment", "global", "drinks", "food", "lookup", "cocktaildb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/cocktails/ingredients", "x-examples": {} } }, "/api/v1/carbonintensity/postcode/{postcode}": { "get": { "description": "Get the regional carbon intensity of the UK electricity grid for a specific postcode area. Different parts of the UK have different energy mixes (e.g., Scotland has more wind, southeast England has more gas). Returns the local carbon intensity and generation mix. Useful for localized energy dashboards, regional sustainability comparisons, and helping UK residents understand their local grid's environmental impact.", "operationId": "science_carbonintensity_postcode", "parameters": [ { "description": "UK postcode", "in": "path", "name": "postcode", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "UK Carbon by Postcode", "tags": [ "science", "united-kingdom", "europe", "power", "environment", "realtime", "carbonintensity-org-uk", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/carbonintensity/postcode/SW1A", "x-examples": { "Carbon intensity in Edinburgh": "curl https://nordapi.ee/api/v1/carbonintensity/postcode/EH1", "Carbon intensity in Manchester": "curl https://nordapi.ee/api/v1/carbonintensity/postcode/M1", "Carbon intensity in Westminster": "curl https://nordapi.ee/api/v1/carbonintensity/postcode/SW1A" } } }, "/api/v1/space/iss": { "get": { "description": "Get the current real-time position of the International Space Station, including latitude, longitude, and the timestamp of the reading. The ISS orbits Earth every ~90 minutes at about 28,000 km/h. Useful for ISS tracker apps, educational tools showing the station's path over Earth, and notification systems that alert users when the ISS is passing overhead. Data from the ISS tracking API, updated every few seconds.", "operationId": "science_space_iss", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "ISS Location", "tags": [ "science", "global", "space", "realtime", "open-notify", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/space/iss", "x-examples": {} } }, "/api/v1/space/astronauts": { "get": { "description": "Get a list of all humans currently in space right now, including their names and which spacecraft they are aboard (ISS, Tiangong, etc.). Typically 6-12 people at any given time. A fascinating real-time dataset for science education apps, space news dashboards, and trivia features. Updated whenever crew missions launch or return.", "operationId": "science_space_astronauts", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "People in Space", "tags": [ "science", "global", "space", "realtime", "open-notify", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/space/astronauts", "x-examples": {} } }, "/api/v1/vehicles/models/{make}": { "get": { "description": "Get all models for a given vehicle manufacturer.", "operationId": "geography_vehicle_models", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Vehicle Models", "tags": [ "geography", "united-states", "americas", "vehicles", "transport", "lookup", "nhtsa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/vehicles/models/Honda", "x-examples": {} } }, "/api/v1/congress/senate": { "get": { "description": "Access recent US Senate stock trading disclosures as required by the STOCK Act. Returns senator names, stock tickers, transaction types (purchase/sale), and reported dollar ranges. Filter by specific stock ticker or senator name. Useful for tracking congressional trading activity, building political finance transparency tools, and analyzing whether senators trade ahead of legislation. Data from official Senate financial disclosures.", "operationId": "finance_congress_senate", "parameters": [ { "description": "Filter by stock ticker", "in": "path", "name": "ticker", "required": true, "schema": { "type": "string" } }, { "description": "Filter by senator name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Senate Stock Trades", "tags": [ "finance", "united-states", "americas", "civic", "realtime", "us-congress", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/congress/senate", "x-examples": { "All recent Senate trades": "curl https://nordapi.ee/api/v1/congress/senate", "Senate trades by a specific senator": "curl \"https://nordapi.ee/api/v1/congress/senate?name=Pelosi\"", "Senate trades for Apple stock": "curl \"https://nordapi.ee/api/v1/congress/senate?ticker=AAPL\"" } } }, "/api/v1/tarot/search": { "get": { "description": "Search for tarot cards by name or keyword. Returns matching cards with their full details including arcana type, suit, meanings, and descriptions. Supports partial name matching so you can search for 'death', 'tower', 'cups', or 'knight' to find relevant cards. Useful for tarot study apps, card lookup tools, meaning reference features, and building searchable tarot databases.", "operationId": "entertainment_tarot_search", "parameters": [ { "description": "Search query (card name or keyword)", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tarot Card Search", "tags": [ "entertainment", "global", "games", "search", "tarotapi", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/tarot/search?q=death\"", "x-examples": { "Search for Tower card": "curl \"https://nordapi.ee/api/v1/tarot/search?q=tower\"", "Search for all Cups cards": "curl \"https://nordapi.ee/api/v1/tarot/search?q=cups\"", "Search for the Death card": "curl \"https://nordapi.ee/api/v1/tarot/search?q=death\"" } } }, "/api/v1/congress/house": { "get": { "description": "Access recent US House of Representatives stock trading disclosures as required by the STOCK Act. Returns representative names, stock tickers, transaction types, and reported dollar ranges. Filter by specific stock ticker or representative name. Useful for tracking congressional insider trading activity, building political accountability dashboards, and comparing House trading patterns to market movements.", "operationId": "finance_congress_house", "parameters": [ { "description": "Filter by stock ticker", "in": "path", "name": "ticker", "required": true, "schema": { "type": "string" } }, { "description": "Filter by representative name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "House Stock Trades", "tags": [ "finance", "united-states", "americas", "civic", "realtime", "us-congress", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/congress/house", "x-examples": { "All recent House trades": "curl https://nordapi.ee/api/v1/congress/house", "House trades for Microsoft stock": "curl \"https://nordapi.ee/api/v1/congress/house?ticker=MSFT\"", "House trades for Tesla": "curl \"https://nordapi.ee/api/v1/congress/house?ticker=TSLA\"" } } }, "/api/v1/lightpollution": { "get": { "description": "Get an estimated Bortle class (1-9) for any location based on nearby population density. This is an estimate, not a satellite measurement - it uses weighted population within 100km to approximate sky brightness. Returns Bortle class, sky quality rating, estimated naked-eye star count, SQM (Sky Quality Meter) estimate, and aurora viewing suitability. Accurate for major cities and remote areas; less precise for suburbs. Useful for astronomy apps, aurora tourism, astrophotography planning, and dark sky awareness.", "operationId": "science_lightpollution", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Light Pollution Estimate", "tags": [ "science", "global", "astronomy", "environment", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/lightpollution?lat=59.437&lon=24.754\"", "x-examples": { "Central London": "curl \"https://nordapi.ee/api/v1/lightpollution?lat=51.51&lon=-0.13\"", "Lofoten, Norway (dark sky)": "curl \"https://nordapi.ee/api/v1/lightpollution?lat=68.2&lon=14.6\"", "Rural Iceland": "curl \"https://nordapi.ee/api/v1/lightpollution?lat=65.0&lon=-18.0\"", "Tallinn, Estonia": "curl \"https://nordapi.ee/api/v1/lightpollution?lat=59.437&lon=24.754\"" } } }, "/api/v1/peatus/routes": { "get": { "description": "Search public transport routes across Estonia by name or number. Returns route short name, long name, transport mode, and operating agency.", "operationId": "estonia_peatus_routes", "parameters": [ { "description": "Route name or number to search", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Transport Routes", "tags": [ "estonia", "baltic", "transport", "search", "peatus-ee", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/peatus/routes?name=1\"", "x-examples": {} } }, "/api/v1/cocktails/random": { "get": { "description": "Get a random cocktail recipe with full details: name, image, ingredients with measurements, mixing instructions, glass type, and category. Perfect for 'surprise me' drink features, cocktail-of-the-day widgets, bartending practice tools, and social gathering apps. Data from TheCocktailDB covering hundreds of classic and modern cocktails.", "operationId": "entertainment_cocktails_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Cocktail", "tags": [ "entertainment", "global", "drinks", "food", "computed", "cocktaildb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/cocktails/random", "x-examples": {} } }, "/api/v1/covid/global": { "get": { "description": "Global COVID-19 pandemic statistics including total cases, deaths, recovered, active cases, critical cases, tests administered, and per-million rates. Historical data preserved as a public health reference. Data from disease.sh aggregating Johns Hopkins, Worldometers, and government sources.", "operationId": "science_covid_global", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "COVID-19 Global Statistics", "tags": [ "science", "global", "health", "statistics", "snapshot-history", "disease-sh", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/covid/global", "x-examples": {} } }, "/api/v1/airquality/current": { "get": { "description": "Get current air quality data for any location on Earth, including PM2.5, PM10, ozone (O3), nitrogen dioxide (NO2), and an overall Air Quality Index (AQI) score. Requires latitude and longitude coordinates. Essential for health-conscious apps, outdoor exercise planners, allergy trackers, and environmental monitoring dashboards. Data from Open-Meteo air quality models.", "operationId": "geo_airquality_current", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Current Air Quality", "tags": [ "geo", "global", "weather", "environment", "realtime", "open-meteo", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/airquality/current?lat=59.9&lon=10.7\"", "x-examples": { "Air quality in Beijing": "curl \"https://nordapi.ee/api/v1/airquality/current?lat=39.9&lon=116.4\"", "Air quality in Los Angeles": "curl \"https://nordapi.ee/api/v1/airquality/current?lat=34.05&lon=-118.24\"", "Air quality in Oslo": "curl \"https://nordapi.ee/api/v1/airquality/current?lat=59.9&lon=10.7\"" } } }, "/api/v1/economics/{country}": { "get": { "description": "Get all 15 economic indicators for a specific country in a single request, each with multiple years of historical data. Returns GDP, inflation, unemployment, PPP, trade balance, government debt, population, and more. Ideal for building country economic profile pages, research dashboards, and investment analysis tools. Data from the World Bank, typically covering the most recent 5-10 years of available data.", "operationId": "finance_economics_country", "parameters": [ { "description": "ISO country code", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Country Economics", "tags": [ "finance", "global", "reference", "lookup", "world-bank", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/economics/NO", "x-examples": { "Japan economic indicators": "curl https://nordapi.ee/api/v1/economics/JP", "Norway economic indicators": "curl https://nordapi.ee/api/v1/economics/NO", "United States economic indicators": "curl https://nordapi.ee/api/v1/economics/US" } } }, "/api/v1/pollen/station/{code}": { "get": { "description": "Get the latest pollen reading for a specific MeteoSwiss monitoring station. Returns concentrations in particles/m³ for all 7 pollen types (alder, birch, hazel, beech, ash, oak, grasses) along with station metadata. Use /pollen/stations to find valid station codes.", "operationId": "geo_pollen_station", "parameters": [ { "description": "Station code (e.g. PZH, PBE, PGE)", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Station Pollen Reading", "tags": [ "geo", "switzerland", "europe", "environment", "health", "realtime", "pollen-meteoswiss", "cc-by", "none" ], "x-example": "curl https://nordapi.ee/api/v1/pollen/station/PZH", "x-examples": { "Pollen in Basel": "curl https://nordapi.ee/api/v1/pollen/station/PBS", "Pollen in Geneva": "curl https://nordapi.ee/api/v1/pollen/station/PGE", "Pollen in Zürich": "curl https://nordapi.ee/api/v1/pollen/station/PZH" } } }, "/api/v1/countrydata": { "get": { "description": "Get comprehensive data for all 250 countries and territories worldwide, including official name, capital, population, area, region, subregion, languages, currencies, calling codes, top-level domains, borders, and flag information. A complete geographic reference dataset. Useful for building country selector components, geography education tools, and reference applications.", "operationId": "geo_countrydata", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "All Countries", "tags": [ "geo", "global", "geography", "reference", "lookup", "rest-countries", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/countrydata", "x-examples": {} } }, "/api/v1/mashup/study/abroad": { "get": { "description": "Compare study abroad destinations: combines university data, cost of living, weather, holidays, and country profiles for multiple destinations.", "operationId": "mashups_study_abroad", "parameters": [ { "description": "Home country code", "in": "query", "name": "home", "required": true, "schema": { "type": "string" } }, { "description": "Comma-separated destination codes", "in": "query", "name": "destinations", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Study Abroad Advisor", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/study/abroad?home=US&destinations=EE,NO,DE\"", "x-examples": {} } }, "/api/v1/estonian-webcams/cities": { "get": { "description": "List all cities with webcams and camera counts.", "operationId": "estonia_ee_webcam_cities", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Webcam Cities", "tags": [ "estonia", "baltic", "cameras", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-webcams/cities", "x-examples": {} } }, "/api/v1/mashup/climate/risk": { "get": { "description": "Property climate resilience score: combines seismic history, elevation (flood risk), air quality, and marine conditions into a composite risk assessment with scores for seismic, flood, and air quality factors.", "operationId": "mashups_climate_risk", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Real Estate Climate Risk", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/climate/risk?lat=59.4&lon=24.7\"", "x-examples": {} } }, "/api/v1/vehicles/types/{make}": { "get": { "description": "Get all vehicle types produced by a given manufacturer (car, truck, motorcycle, etc.).", "operationId": "geography_vehicle_types", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Vehicle Types", "tags": [ "geography", "united-states", "americas", "vehicles", "transport", "lookup", "nhtsa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/vehicles/types/Mercedes", "x-examples": {} } }, "/api/v1/whois/{domain}": { "get": { "description": "Look up WHOIS registration data for any domain name. Returns the domain registrar, creation date, expiration date, nameservers, registration status, and available registrant contact information. Useful for domain research tools, brand protection monitoring, checking domain availability and age, due diligence on websites, and building domain management dashboards.", "operationId": "tools_whois", "parameters": [ { "description": "Domain", "in": "query", "name": "domain", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "WHOIS Lookup", "tags": [ "tools", "global", "dns", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/whois/google.com", "x-examples": { "WHOIS for github.com": "curl https://nordapi.ee/api/v1/whois/github.com", "WHOIS for google.com": "curl https://nordapi.ee/api/v1/whois/google.com", "WHOIS for nordapi.ee": "curl https://nordapi.ee/api/v1/whois/nordapi.ee" } } }, "/api/v1/convert/batch": { "get": { "description": "Convert a single amount from one base currency into multiple target currencies in a single API call. Returns the converted amount and exchange rate for each target currency. Far more efficient than making individual conversion requests when you need to display prices in multiple currencies simultaneously, such as on international pricing pages or multi-currency shopping carts.", "operationId": "finance_convert_batch", "parameters": [ { "description": "Source currency", "in": "query", "name": "from", "required": true, "schema": { "type": "string" } }, { "description": "Amount", "in": "query", "name": "amount", "required": true, "schema": { "type": "string" } }, { "description": "Comma-separated target currencies", "in": "query", "name": "to", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Batch Convert", "tags": [ "finance", "global", "computed", "frankfurter", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/convert/batch?from=USD&amount=100&to=EUR,GBP,NOK\"", "x-examples": { "Convert EUR to Asian currencies": "curl \"https://nordapi.ee/api/v1/convert/batch?from=EUR&amount=250&to=JPY,CNY,INR\"", "Convert USD to European currencies": "curl \"https://nordapi.ee/api/v1/convert/batch?from=USD&amount=100&to=EUR,GBP,NOK\"", "Salary in multiple Nordic currencies": "curl \"https://nordapi.ee/api/v1/convert/batch?from=USD&amount=5000&to=NOK,SEK,DKK\"" } } }, "/api/v1/tides/temperature/{station}": { "get": { "description": "Get the current water temperature reading at a specific NOAA tide station. Returns the latest observed sea surface temperature. Useful for swimming and water sports apps, marine biology monitoring, fishing condition tools, and coastal tourism features. Data from live NOAA temperature sensors at US coastal stations.", "operationId": "geo_tides_temp", "parameters": [ { "description": "Station ID", "in": "path", "name": "station", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Water Temperature", "tags": [ "geo", "united-states", "americas", "weather", "realtime", "noaa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tides/temperature/9414290", "x-examples": { "Water temperature at Key West": "curl https://nordapi.ee/api/v1/tides/temperature/8724580", "Water temperature at San Francisco": "curl https://nordapi.ee/api/v1/tides/temperature/9414290" } } }, "/api/v1/estonian-qualifications/awarding-bodies": { "get": { "description": "List 129 qualification awarding bodies.", "operationId": "estonia_ee_qual_bodies", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Awarding Bodies", "tags": [ "estonia", "baltic", "education", "reference", "lookup", "kutseregister", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-qualifications/awarding-bodies", "x-examples": {} } }, "/api/v1/mashup/song/lyrics": { "get": { "description": "Search for a song and get both the track info and full lyrics in one response.", "operationId": "mashups_song_lyrics", "parameters": [ { "description": "Song search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Song + Lyrics Combo", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/song/lyrics?q=bohemian+rhapsody\"", "x-examples": {} } }, "/api/v1/estonian-monuments/search": { "get": { "description": "Search monuments by name or description.", "operationId": "estonia_ee_monument_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Monuments", "tags": [ "estonia", "baltic", "heritage", "search", "register-muinas", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-monuments/search?q=church\"", "x-examples": {} } }, "/api/v1/electricity/history/{zone}": { "get": { "description": "Get historical electricity spot prices for a specific Nordic bidding zone over a custom date range. Returns hourly prices for every day in the range. Useful for analyzing long-term electricity price trends, calculating average costs over billing periods, building historical price charts, and performing seasonal analysis of energy costs in Norway and Sweden. Data from Nord Pool.", "operationId": "electricity_history", "parameters": [ { "description": "Zone", "in": "path", "name": "zone", "required": true, "schema": { "type": "string" } }, { "description": "Start", "in": "query", "name": "start_date", "required": true, "schema": { "type": "string" } }, { "description": "End", "in": "query", "name": "end_date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Price History", "tags": [ "electricity", "global", "nordic", "power", "snapshot-history", "hvakosterstrommen", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/electricity/history/NO1?start_date=2026-03-20&end_date=2026-03-24\"", "x-examples": { "Bergen area price history for a weekend": "curl \"https://nordapi.ee/api/v1/electricity/history/NO5?start_date=2026-03-21&end_date=2026-03-22\"", "Oslo price history for a week": "curl \"https://nordapi.ee/api/v1/electricity/history/NO1?start_date=2026-03-17&end_date=2026-03-24\"", "Stockholm price history for March": "curl \"https://nordapi.ee/api/v1/electricity/history/SE3?start_date=2026-03-01&end_date=2026-03-24\"" } } }, "/api/v1/mashup/festival/finder": { "get": { "description": "Discover upcoming festivals and events: combines public holidays, shopping events, weather forecasts, and country data for any country. Filter by how far ahead to look.", "operationId": "mashups_festival_finder", "parameters": [ { "description": "Country code", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } }, { "description": "Months ahead to search (default 3)", "in": "query", "name": "months", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Festival & Event Finder", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/festival/finder?country=EE&months=6\"", "x-examples": {} } }, "/api/v1/estonian-stats/browse": { "get": { "description": "Browse the hierarchical Statistics Estonia database by path. Navigate through categories, subcategories, and tables. Use the categories endpoint to discover top-level paths.", "operationId": "estonia_stats_browse", "parameters": [ { "description": "Hierarchical path (e.g. rahvastik, majandus)", "in": "query", "name": "path", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Browse Statistics Estonia", "tags": [ "estonia", "baltic", "statistics", "lookup", "statistikaamet", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-stats/browse?path=rahvastik\"", "x-examples": {} } }, "/api/v1/words/similar/{word}": { "get": { "description": "Find words with similar meanings (synonyms and related words) using the Datamuse word-finding engine. Returns words ranked by relevance score.", "operationId": "language_words_similar", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Similar Words", "tags": [ "language", "global", "lookup", "datamuse", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/words/similar/happy", "x-examples": {} } }, "/api/v1/emoji/category/{category}": { "get": { "description": "Get all emojis in a specific category (e.g., smileys-and-people, animals-and-nature, food-and-drink, travel-and-places, activities, objects, symbols, flags). Useful for building tabbed emoji pickers, category-filtered emoji search, and emoji browsing interfaces organized by theme.", "operationId": "food_emoji_category", "parameters": [ { "description": "Category", "in": "path", "name": "category", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Emojis by Category", "tags": [ "food", "global", "reference", "lookup", "emojihub", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/emoji/category/smileys-and-people", "x-examples": { "Animal and nature emojis": "curl https://nordapi.ee/api/v1/emoji/category/animals-and-nature", "Food and drink emojis": "curl https://nordapi.ee/api/v1/emoji/category/food-and-drink", "Smiley and people emojis": "curl https://nordapi.ee/api/v1/emoji/category/smileys-and-people" } } }, "/api/v1/search": { "get": { "description": "Search across all NordAPI endpoints by keyword. Returns matching categories and endpoints with relevance scoring, making it easy to discover available APIs programmatically. Searches endpoint names, descriptions, paths, and parameter names. Useful for building API explorers, documentation search features, integration discovery tools, and chatbots that help users find the right API endpoint for their needs.", "operationId": "tools_search", "parameters": [ { "description": "Search query keyword", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "API Endpoint Search", "tags": [ "tools", "global", "search", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/search?q=weather\"", "x-examples": { "Search for currency endpoints": "curl \"https://nordapi.ee/api/v1/search?q=currency\"", "Search for generate endpoints": "curl \"https://nordapi.ee/api/v1/search?q=generate\"", "Search for weather-related endpoints": "curl \"https://nordapi.ee/api/v1/search?q=weather\"" } } }, "/api/v1/bible/random": { "get": { "description": "Get a random well-known Bible verse from a curated selection of 20 popular passages including John 3:16, Psalm 23, Romans 8:28, and more.", "operationId": "scripture_bible_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Bible Verse", "tags": [ "scripture", "global", "lookup", "bible-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/bible/random", "x-examples": {} } }, "/api/v1/covid/vaccines": { "get": { "description": "Global COVID-19 vaccination coverage over the last 30 days showing daily and cumulative doses administered worldwide. Useful for tracking vaccination progress and public health research.", "operationId": "science_covid_vaccines", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "COVID-19 Vaccination Data", "tags": [ "science", "global", "health", "statistics", "snapshot-history", "disease-sh", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/covid/vaccines", "x-examples": {} } }, "/api/v1/crypto/summary/{coin_id}": { "get": { "description": "Get aggregate statistics for a coin's price history: total data points, date range covered, and min/max/average USD prices. Useful for understanding how much historical data is available and getting a quick statistical overview.", "operationId": "finance_crypto_summary", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Crypto History Summary", "tags": [ "finance", "global", "crypto", "computed", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/crypto/summary/bitcoin", "x-examples": {} } }, "/api/v1/breweries/city/{city}": { "get": { "description": "Find all breweries in a specific city. Returns brewery names, types, addresses, phone numbers, and websites for every brewery in the given city. Useful for travel planning apps, local craft beer guides, brewery crawl route planners, and city-specific entertainment directories. Data from Open Brewery DB.", "operationId": "food_breweries_city", "parameters": [ { "description": "City", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Breweries by City", "tags": [ "food", "global", "drinks", "business", "lookup", "breweries", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/breweries/city/portland", "x-examples": { "Breweries in Denver": "curl https://nordapi.ee/api/v1/breweries/city/denver", "Breweries in Portland": "curl https://nordapi.ee/api/v1/breweries/city/portland", "Breweries in San Diego": "curl https://nordapi.ee/api/v1/breweries/city/san_diego" } } }, "/api/v1/poetry/collection": { "get": { "description": "Get multiple random poems in one request. Perfect for building poetry feeds or discovery features.", "operationId": "language_poetry_collection", "parameters": [ { "description": "Number of poems (1-10)", "in": "query", "name": "count", "required": false, "schema": { "default": "5", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Poetry Collection", "tags": [ "language", "global", "poetry", "batch", "poetrydb", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/poetry/collection?count=3\"", "x-examples": {} } }, "/api/v1/estonian-geology/deposits": { "get": { "description": "Mineral deposit data from the Estonian Geology Fund (fond.egt.ee). Includes limestone, dolomite, phosphorite, sand, peat, and more.", "operationId": "estonia_ee_geology_deposits", "parameters": [ { "description": "Mineral type filter", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } }, { "description": "County filter", "in": "query", "name": "county", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Mineral Deposits", "tags": [ "estonia", "baltic", "environment", "science", "lookup", "egf-fond", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-geology/deposits", "x-examples": {} } }, "/api/v1/shopping/calendar/{year}": { "get": { "description": "Get the complete calendar of shopping events and sale holidays for an entire year, across all supported countries. Returns every event with dates, descriptions, and categories. Perfect for annual marketing planning, editorial calendars, and retail strategy tools that need to see the full year of commercial events at a glance.", "operationId": "world_shopping_calendar", "parameters": [ { "description": "Year", "in": "query", "name": "year", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Shopping Calendar", "tags": [ "world", "global", "business", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/shopping/calendar/2026", "x-examples": { "2027 shopping calendar": "curl https://nordapi.ee/api/v1/shopping/calendar/2027", "Full 2026 shopping calendar": "curl https://nordapi.ee/api/v1/shopping/calendar/2026" } } }, "/api/v1/tallinn/data/excavation-permits": { "get": { "description": "Excavation permits issued in Tallinn for construction and utility works.", "operationId": "estonia_tallinn_excavation_permits", "parameters": [ { "description": "Results per page", "in": "query", "name": "per_page", "required": false, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Excavation Permits", "tags": [ "estonia", "baltic", "civic", "lookup", "avaandmed-tallinn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/data/excavation-permits", "x-examples": {} } }, "/api/v1/profanity/check": { "get": { "description": "Check if text contains profanity. Returns true or false.", "operationId": "texttools_profanity_check", "parameters": [ { "description": "Text to check", "in": "query", "name": "text", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Profanity Check", "tags": [ "texttools", "global", "tools", "text", "lookup", "purgomalum", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/profanity/check?text=hello+world\"", "x-examples": {} } }, "/api/v1/tallinn/data/population": { "get": { "description": "Population data for Tallinn by district and demographics.", "operationId": "estonia_tallinn_population", "parameters": [ { "description": "Results per page", "in": "query", "name": "per_page", "required": false, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Population", "tags": [ "estonia", "baltic", "statistics", "civic", "lookup", "avaandmed-tallinn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/data/population", "x-examples": {} } }, "/api/v1/estonian-health/query": { "get": { "description": "Generic query endpoint for any TEHIK health data table. Use the datasets endpoint to discover available schemas and tables.", "operationId": "estonia_ee_health_query", "parameters": [ { "description": "Schema: covid19, vaccination, or flu", "in": "query", "name": "schema", "required": true, "schema": { "type": "string" } }, { "description": "Table name (from datasets endpoint)", "in": "query", "name": "table", "required": true, "schema": { "type": "string" } }, { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } }, { "description": "Offset", "in": "query", "name": "offset", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Query Estonian Health Data", "tags": [ "estonia", "baltic", "health", "search", "tehik", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-health/query?schema=covid19&table=opendata_covid19_hospitalization&limit=5\"", "x-examples": {} } }, "/api/v1/vehicles/vin/{vin}": { "get": { "description": "Decode a Vehicle Identification Number (VIN) to get detailed vehicle specifications: make, model, year, engine, transmission, body type, and more.", "operationId": "geography_vehicle_vin", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Decode VIN", "tags": [ "geography", "united-states", "americas", "vehicles", "transport", "lookup", "nhtsa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/vehicles/vin/1HGBH41JXMN109186", "x-examples": {} } }, "/api/v1/bikes/network/{network}": { "get": { "description": "Get all bike docking stations in a specific bike-sharing network, including the number of available bikes and empty slots at each station in real-time. Provide the network ID (e.g., oslo-bysykkel for Oslo City Bike). Useful for building bike-sharing apps, urban mobility dashboards, station availability maps, and tools that help cyclists find the nearest available bike or empty dock. Data from CityBikes covering 600+ cities worldwide.", "operationId": "tools_bikes_stations", "parameters": [ { "description": "Network ID", "in": "query", "name": "network", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Bike Stations", "tags": [ "tools", "global", "transport", "realtime", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/bikes/network/oslo-bysykkel", "x-examples": { "London Santander Cycles stations": "curl https://nordapi.ee/api/v1/bikes/network/santander-cycles", "Oslo City Bike stations": "curl https://nordapi.ee/api/v1/bikes/network/oslo-bysykkel", "Paris Velib stations": "curl https://nordapi.ee/api/v1/bikes/network/velib" } } }, "/api/v1/tallinn/sports": { "get": { "description": "Swimming pools (50m Kalev Spa, 25m city pools), major parks (Kadriorg, Tondiraba, Pirita), 342 public playgrounds, skate parks, and dog parks across Tallinn's 8 districts.", "operationId": "estonia_tallinn_sports", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Sports & Recreation", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-life", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/sports", "x-examples": {} } }, "/api/v1/currencies": { "get": { "description": "Get the complete list of all 30 supported fiat currencies with their ISO 4217 codes, full names, and symbols. Use this to populate currency dropdowns, validate user input, or discover which currencies are available across all exchange rate endpoints. Covers major world currencies including USD, EUR, GBP, NOK, SEK, JPY, and 24 more.", "operationId": "finance_currencies", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "List All Currencies", "tags": [ "finance", "global", "lookup", "frankfurter", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/currencies", "x-examples": {} } }, "/api/v1/animals/cats/fact": { "get": { "description": "Get a random fun fact about cats. Each call returns a different interesting, surprising, or amusing piece of cat trivia (e.g., 'Cats sleep for about 70% of their lives'). Perfect for cat lover apps, daily notification features, social media content generators, and educational pet care tools.", "operationId": "entertainment_cats_fact", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cat Fact", "tags": [ "entertainment", "global", "computed", "cat-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/animals/cats/fact", "x-examples": {} } }, "/api/v1/pollen/station/{code}/history": { "get": { "description": "Historical pollen data for a station with date range. Up to 5 years of hourly sensor data. Supports daily aggregation for longer ranges. Useful for seasonal pattern analysis, year-over-year allergy trend comparisons, and research into pollen season timing shifts.", "operationId": "geo_pollen_history", "parameters": [ { "description": "Station code (e.g. PZH, PBE)", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } }, { "description": "Start date YYYY-MM-DD (default: 7 days ago)", "in": "query", "name": "start_date", "required": false, "schema": { "type": "string" } }, { "description": "End date YYYY-MM-DD (default: today)", "in": "query", "name": "end_date", "required": false, "schema": { "type": "string" } }, { "description": "hourly or daily (default: hourly)", "in": "query", "name": "resolution", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Pollen History", "tags": [ "geo", "switzerland", "europe", "environment", "health", "snapshot-history", "pollen-meteoswiss", "cc-by", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/pollen/station/PZH/history?start_date=2026-04-01&end_date=2026-04-10\"", "x-examples": { "April daily averages in Bern": "curl \"https://nordapi.ee/api/v1/pollen/station/PBE/history?start_date=2026-04-01&end_date=2026-04-30&resolution=daily\"", "Birch season comparison (spring 2025 vs 2026)": "curl \"https://nordapi.ee/api/v1/pollen/station/PZH/history?start_date=2025-03-01&end_date=2025-05-31&resolution=daily\"", "Last week in Zürich (hourly)": "curl \"https://nordapi.ee/api/v1/pollen/station/PZH/history?start_date=2026-04-03&end_date=2026-04-10\"" } } }, "/api/v1/placeholder/random": { "get": { "description": "Generate URLs for random placeholder images from Lorem Picsum. Perfect for wireframes, mockups, and development. Returns direct image URLs in multiple styles including grayscale and blur effects. No hotlinking limits.", "operationId": "tools_placeholder_random", "parameters": [ { "description": "Image width in pixels", "in": "query", "name": "width", "required": false, "schema": { "default": "600", "type": "string" } }, { "description": "Image height in pixels", "in": "query", "name": "height", "required": false, "schema": { "default": "400", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Placeholder Image", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/placeholder/random?width=800&height=600\"", "x-examples": { "Banner size 1200x300": "curl \"https://nordapi.ee/api/v1/placeholder/random?width=1200&height=300\"", "Default 600x400 image": "curl https://nordapi.ee/api/v1/placeholder/random", "Square 500x500 image": "curl \"https://nordapi.ee/api/v1/placeholder/random?width=500&height=500\"" } } }, "/api/v1/riha/systems": { "get": { "description": "Browse all 1,382+ Estonian government information systems registered in RIHA. Each entry includes system name, owner organization, security classification (ISKE standard), status, and homepage. Search by name, filter by status (IN_USE, FINISHED), or by owner registry code.", "operationId": "estonia_riha_systems", "parameters": [ { "description": "Search by system name", "in": "query", "name": "q", "required": false, "schema": { "type": "string" } }, { "description": "Filter: IN_USE, FINISHED, ESTABLISHING", "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "description": "Owner organization registry code", "in": "query", "name": "owner", "required": false, "schema": { "type": "string" } }, { "description": "Results per page", "in": "path", "name": "limit", "required": true, "schema": { "default": "20", "type": "string" } }, { "description": "Offset for pagination", "in": "query", "name": "offset", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Government IT Systems", "tags": [ "estonia", "baltic", "reference", "civic", "search", "riha", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/riha/systems?status=IN_USE&limit=5\"", "x-examples": {} } }, "/api/v1/tallinn/beaches": { "get": { "description": "All Tallinn beaches with lengths, facilities, Blue Flag status, water quality ratings, and the beach flag system (green/yellow/red). Includes Pirita, Stroomi, Pikakari, Kakumäe, and Harku lake. Tip: get real-time sea temperature via /estonian-weather/station/Pirita.", "operationId": "estonia_tallinn_beaches", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Beaches", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-life", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/beaches", "x-examples": {} } }, "/api/v1/spaceweather/kp": { "get": { "description": "Get recent planetary K-index (Kp) values from NOAA SWPC, the primary indicator of geomagnetic storm activity. The Kp index ranges from 0 (quiet) to 9 (extreme storm). Values of 5+ indicate geomagnetic storms visible as aurora at lower latitudes. Returns a time series of recent Kp readings. Critical for aurora prediction apps, satellite drag calculations, GPS accuracy monitoring, and space weather dashboards.", "operationId": "science_spaceweather_kp", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Kp Geomagnetic Index", "tags": [ "science", "global", "geomagnetic", "space", "realtime", "noaa-swpc", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/spaceweather/kp", "x-examples": {} } }, "/api/v1/geo/sun": { "get": { "description": "Get sunrise, sunset, solar noon, and civil/nautical/astronomical twilight times for any location and date. Returns all times in UTC. Useful for photography apps (golden hour planning), outdoor activity schedulers, smart home lighting automation, religious observance apps, and solar energy production estimates. Especially relevant in Nordic regions with extreme daylight variations.", "operationId": "geo_geo_sun", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } }, { "description": "Date", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Sunrise & Sunset", "tags": [ "geo", "global", "astronomy", "reference", "lookup", "sunrise-sunset", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/geo/sun?lat=59.9&lon=10.7\"", "x-examples": { "Sunrise and sunset in Oslo today": "curl \"https://nordapi.ee/api/v1/geo/sun?lat=59.9&lon=10.7\"", "Sunrise in Tromso on midsummer": "curl \"https://nordapi.ee/api/v1/geo/sun?lat=69.65&lon=18.96&date=2026-06-21\"", "Sunset in Cape Town on a specific date": "curl \"https://nordapi.ee/api/v1/geo/sun?lat=-33.93&lon=18.42&date=2026-12-25\"" } } }, "/api/v1/estonian-medical-devices/search": { "get": { "description": "Search medical devices by name, manufacturer, or model.", "operationId": "estonia_ee_medical_devices_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Medical Devices", "tags": [ "estonia", "baltic", "health", "civic", "search", "msa-sm", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-medical-devices/search?q=insulin\"", "x-examples": {} } }, "/api/v1/mashup/culture/explorer": { "get": { "description": "Deep cultural profile for any country: combines country demographics, upcoming holidays, related artworks from the Met Museum and Art Institute of Chicago, top universities, and popular free-to-play games into a comprehensive cultural overview.", "operationId": "mashups_culture_explorer", "parameters": [ { "description": "ISO 3166-1 alpha-2 country code (e.g. FR, JP, NO)", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Culture Explorer", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/culture/explorer?code=JP\"", "x-examples": {} } }, "/api/v1/github/user/{username}": { "get": { "description": "Get a public GitHub user profile by username, including display name, bio, avatar URL, company, location, public repo count, follower/following counts, and account creation date. Useful for developer portfolio tools, team pages that pull data from GitHub, recruitment platforms, and open source contributor profiles. Data from the GitHub REST API.", "operationId": "news_github_user", "parameters": [ { "description": "GitHub username", "in": "query", "name": "username", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "GitHub User", "tags": [ "news", "global", "social", "lookup", "github", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/github/user/torvalds", "x-examples": { "Jose Valim GitHub profile": "curl https://nordapi.ee/api/v1/github/user/josevalim", "Linus Torvalds GitHub profile": "curl https://nordapi.ee/api/v1/github/user/torvalds", "Sindre Sorhus GitHub profile": "curl https://nordapi.ee/api/v1/github/user/sindresorhus" } } }, "/api/v1/weather/cities": { "get": { "description": "Get the full list of 30 major cities that support city-name-based weather lookups. Returns city names and their coordinates. Use this to populate city dropdown menus or validate user input before calling the weather endpoints. Covers global capitals and major urban centers across all continents.", "operationId": "geo_weather_cities", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Available Cities", "tags": [ "geo", "global", "weather", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/weather/cities", "x-examples": {} } }, "/api/v1/spaceweather/sunspots": { "get": { "description": "Get recent daily sunspot numbers from NOAA SWPC, tracking solar activity levels. Sunspot numbers correlate with the 11-year solar cycle and predict space weather intensity. Higher sunspot counts mean more frequent solar flares, coronal mass ejections, and aurora displays. Useful for solar cycle tracking dashboards, long-term space weather forecasting, amateur astronomy tools, and climate research applications studying solar irradiance variability.", "operationId": "science_spaceweather_sunspots", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Sunspot Numbers", "tags": [ "science", "global", "geomagnetic", "space", "realtime", "noaa-swpc", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/spaceweather/sunspots", "x-examples": {} } }, "/api/v1/estonian-geology/domains": { "get": { "description": "List geological research domains and categories from the Estonian Geology Fund.", "operationId": "estonia_ee_geology_domains", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Geological Research Domains", "tags": [ "estonia", "baltic", "environment", "science", "lookup", "egf-fond", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-geology/domains", "x-examples": {} } }, "/api/v1/weather/historical": { "get": { "description": "Retrieve historical weather data for any location and date range from the Open-Meteo archive. Returns daily temperature, precipitation, wind, and other weather variables for past dates. Requires latitude/longitude coordinates and a date range. Useful for climate analysis, agricultural research, insurance claims verification, event post-mortems, and comparing current conditions to historical norms.", "operationId": "geo_weather_historical", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } }, { "description": "Start date", "in": "query", "name": "start_date", "required": true, "schema": { "type": "string" } }, { "description": "End date", "in": "query", "name": "end_date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Historical Weather", "tags": [ "geo", "global", "weather", "snapshot-history", "open-meteo-archive", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/weather/historical?lat=59.9&lon=10.7&start_date=2025-01-01&end_date=2025-01-31\"", "x-examples": { "Historical weather for Oslo in January 2025": "curl \"https://nordapi.ee/api/v1/weather/historical?lat=59.9&lon=10.7&start_date=2025-01-01&end_date=2025-01-31\"", "Historical weather for Paris in summer 2025": "curl \"https://nordapi.ee/api/v1/weather/historical?lat=48.86&lon=2.35&start_date=2025-06-01&end_date=2025-08-31\"", "Historical weather for Tokyo last week": "curl \"https://nordapi.ee/api/v1/weather/historical?lat=35.68&lon=139.69&start_date=2026-03-17&end_date=2026-03-24\"" } } }, "/api/v1/elevation/batch": { "get": { "description": "Get elevation data for multiple points in a single request (up to 100 locations). Points are pipe-separated lat,lng pairs.", "operationId": "geography_elevation_batch", "parameters": [ { "description": "Pipe-separated coordinates: lat,lng|lat,lng", "in": "query", "name": "locations", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Batch Elevation Lookup", "tags": [ "geography", "global", "batch", "open-topo-data", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/elevation/batch?locations=59.91,10.75|60.39,5.32|63.43,10.40\"", "x-examples": {} } }, "/api/v1/books/isbn/{isbn}": { "get": { "description": "Look up a specific book by its ISBN (International Standard Book Number). Returns detailed book information including title, author, publisher, publication date, page count, subjects, and cover images. Useful for bookstore apps, library management systems, book scanning features, and academic citation tools. Data from Open Library.", "operationId": "food_books_isbn", "parameters": [ { "description": "ISBN", "in": "query", "name": "isbn", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "ISBN Lookup", "tags": [ "food", "global", "reference", "lookup", "open-library", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/books/isbn/9780134685991", "x-examples": { "Look up Clean Code": "curl https://nordapi.ee/api/v1/books/isbn/9780132350884", "Look up The Pragmatic Programmer": "curl https://nordapi.ee/api/v1/books/isbn/9780134685991" } } }, "/api/v1/nasa/asteroids": { "get": { "description": "Get a list of asteroids making close approaches to Earth today, from NASA's Near Earth Object Web Service (NeoWs). Returns asteroid names, estimated diameters, closest approach distances, relative velocities, and whether they are classified as potentially hazardous. Useful for space awareness apps, science education tools, and astronomy dashboards that track objects passing near our planet.", "operationId": "science_nasa_asteroids", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Near-Earth Asteroids", "tags": [ "science", "global", "space", "astronomy", "realtime", "nasa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/nasa/asteroids", "x-examples": {} } }, "/api/v1/emoji/all": { "get": { "description": "Get the complete Unicode emoji catalog with every emoji's character, name, Unicode code point, HTML entity, category, and group. Returns hundreds of emojis organized by their Unicode classifications. Useful for building custom emoji pickers, emoji search features, Unicode reference tools, and any application that needs a complete structured emoji dataset.", "operationId": "food_emoji_all", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "All Emojis", "tags": [ "food", "global", "reference", "lookup", "emojihub", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/emoji/all", "x-examples": {} } }, "/api/v1/time/current": { "get": { "description": "Get the current date and time for any IANA timezone. Returns year, month, day, hour, minute, seconds, formatted datetime, day of week, and DST status.", "operationId": "time_time_current", "parameters": [ { "description": "IANA timezone (e.g. Europe/Oslo, America/New_York, Asia/Tokyo)", "in": "query", "name": "timezone", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Current Time by Timezone", "tags": [ "time", "global", "timezone", "realtime", "timeapi", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/time/current?timezone=Europe/Oslo\"", "x-examples": {} } }, "/api/v1/advice/{id}": { "get": { "description": "Get a specific piece of advice by its ID.", "operationId": "texttools_advice_show", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Get Advice by ID", "tags": [ "texttools", "global", "text", "reference", "lookup", "advice-slip", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/advice/42", "x-examples": {} } }, "/api/v1/estonian-stats/categories": { "get": { "description": "List all top-level statistical categories from Statistics Estonia (Statistikaamet): Environment, Economy, Population, Social life, Multidomain statistics, and more.", "operationId": "estonia_stats_categories", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Statistics Estonia Categories", "tags": [ "estonia", "baltic", "statistics", "lookup", "statistikaamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-stats/categories", "x-examples": {} } }, "/api/v1/universities/search": { "get": { "description": "Search over 10,000 universities worldwide by name or country. Returns university name, website URLs, domains, and country. Useful for building education portals, school comparison tools, university application platforms, and academic research directories. Data covers institutions across all continents with a focus on degree-granting universities.", "operationId": "world_universities", "parameters": [ { "description": "Name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } }, { "description": "Country", "in": "query", "name": "country", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "University Search", "tags": [ "world", "global", "reference", "education", "search", "universities", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/universities/search?country=Norway\"", "x-examples": { "Search by university name": "curl \"https://nordapi.ee/api/v1/universities/search?name=Oxford\"", "Universities in Japan": "curl \"https://nordapi.ee/api/v1/universities/search?country=Japan\"", "Universities in Norway": "curl \"https://nordapi.ee/api/v1/universities/search?country=Norway\"" } } }, "/api/v1/hash": { "get": { "description": "Generate a cryptographic hash of any input string using your choice of algorithm. Supports MD5, SHA-1, SHA-256, SHA-384, and SHA-512. Useful for checksum verification, data integrity checks, and development testing. Computed locally with zero external dependencies.", "operationId": "tools_hash_compute", "parameters": [ { "description": "String to hash", "in": "query", "name": "input", "required": true, "schema": { "type": "string" } }, { "description": "Algorithm: md5, sha1, sha256, sha384, sha512", "in": "query", "name": "algorithm", "required": false, "schema": { "default": "sha256", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Compute Hash", "tags": [ "tools", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/hash?input=hello+world&algorithm=sha256\"", "x-examples": { "MD5 hash": "curl \"https://nordapi.ee/api/v1/hash?input=test123&algorithm=md5\"", "SHA-256 hash": "curl \"https://nordapi.ee/api/v1/hash?input=hello+world&algorithm=sha256\"", "SHA-512 hash": "curl \"https://nordapi.ee/api/v1/hash?input=my+secret+data&algorithm=sha512\"" } } }, "/api/v1/crypto/history/{coin_id}": { "get": { "description": "Get historical price snapshots for any of the top 50 cryptocurrencies. Prices are recorded every 10 minutes, giving up to 144 data points per day per coin. Filter by date range or limit the number of results. Ideal for building price charts, backtesting strategies, and tracking price trends over time.", "operationId": "finance_crypto_history", "parameters": [ { "description": "Max data points (up to 1000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "144", "type": "string" } }, { "description": "Start date (YYYY-MM-DD)", "in": "query", "name": "start_date", "required": false, "schema": { "type": "string" } }, { "description": "End date (YYYY-MM-DD)", "in": "query", "name": "end_date", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Crypto Price History", "tags": [ "finance", "global", "crypto", "snapshot-history", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/crypto/history/bitcoin?limit=10\"", "x-examples": { "Ethereum prices for a specific day": "curl \"https://nordapi.ee/api/v1/crypto/history/ethereum?start_date=2026-03-28&end_date=2026-03-28\"", "Last 10 Bitcoin prices": "curl \"https://nordapi.ee/api/v1/crypto/history/bitcoin?limit=10\"", "Solana price history (last 24h)": "curl \"https://nordapi.ee/api/v1/crypto/history/solana?limit=144\"" } } }, "/api/v1/cards/shuffle/{deck_id}": { "get": { "description": "Reshuffle a previously created deck, returning all drawn cards to the deck.", "operationId": "gaming_cards_shuffle", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Shuffle Deck", "tags": [ "gaming", "global", "games", "computed", "deck-of-cards", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/cards/shuffle/abc123", "x-examples": {} } }, "/api/v1/placeholder/{id}": { "get": { "description": "Get URLs for a specific placeholder image by its Lorem Picsum ID. Useful when you need a consistent image across page loads rather than random ones.", "operationId": "tools_placeholder_id", "parameters": [ { "description": "Image ID from Lorem Picsum", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "Width", "in": "query", "name": "width", "required": false, "schema": { "default": "600", "type": "string" } }, { "description": "Height", "in": "query", "name": "height", "required": false, "schema": { "default": "400", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Specific Placeholder Image", "tags": [ "tools", "global", "generators", "lookup", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/placeholder/237?width=800&height=600\"", "x-examples": { "Image #10 as a banner": "curl \"https://nordapi.ee/api/v1/placeholder/10?width=1200&height=400\"", "Image #237 at default size": "curl https://nordapi.ee/api/v1/placeholder/237" } } }, "/api/v1/time/zones": { "get": { "description": "Get a complete list of all available IANA timezones.", "operationId": "time_time_zones", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "List All Timezones", "tags": [ "time", "global", "timezone", "lookup", "timeapi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/time/zones", "x-examples": {} } }, "/api/v1/avatars/styles": { "get": { "description": "List all 17 available avatar art styles from DiceBear including adventurer, pixel-art, bottts (robots), lorelei, and more. Each style produces a completely different visual aesthetic for generated avatars.", "operationId": "tools_avatars_styles", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Available Avatar Styles", "tags": [ "tools", "global", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/avatars/styles", "x-examples": {} } }, "/api/v1/estonian-webcams": { "get": { "description": "121 public webcams across 50+ locations in Estonia: broadcast tower panoramas (HLS from 150-314m), city views, beaches, lakes, rivers, harbours, lighthouses, ski resorts, wildlife cameras (eagles, seals, storks), and more. Each camera includes name, city, GPS coordinates, category, source, and direct image/stream URL. Cameras with JPEG or HLS URLs include AI-estimated calibration data (pitch, roll, FOV, sky %). Filter by city or category.", "operationId": "estonia_ee_webcams", "parameters": [ { "description": "Filter by city name (e.g. Tallinn, Tartu, Pärnu)", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } }, { "description": "Filter by category: panorama, city, beach, coast, lake, river, wildlife, airport, harbour, border, landmark", "in": "path", "name": "category", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Public Webcams", "tags": [ "estonia", "baltic", "cameras", "lookup", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-webcams?category=panorama\"", "x-examples": {} } }, "/api/v1/holidays/{country_code}/next": { "get": { "description": "Get a list of upcoming public holidays for a specific country, starting from today. Returns holiday names, dates, and types. Perfect for countdown widgets, office planning tools, travel apps that highlight upcoming holidays at a destination, and calendar integrations that need to mark the next few holidays.", "operationId": "world_holidays_next", "parameters": [ { "description": "Country code", "in": "query", "name": "country_code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Next Holidays", "tags": [ "world", "global", "reference", "time", "lookup", "nager-date", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/holidays/US/next", "x-examples": { "Next Japanese holidays": "curl https://nordapi.ee/api/v1/holidays/JP/next", "Next Norwegian holidays": "curl https://nordapi.ee/api/v1/holidays/NO/next", "Next US holidays": "curl https://nordapi.ee/api/v1/holidays/US/next" } } }, "/api/v1/games/stores": { "get": { "description": "List all digital game stores tracked by the deals API (Steam, GOG, Humble Bundle, etc.).", "operationId": "gaming_game_stores", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Game Stores", "tags": [ "gaming", "global", "games", "lookup", "cheapshark", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/games/stores", "x-examples": {} } }, "/api/v1/holidays/{country_code}/{year}": { "get": { "description": "Get all public holidays for a specific country and year. Returns every official holiday with name, date, and type. Useful for building annual calendar views with holidays highlighted, HR systems that calculate working days, and travel planning tools that show the full holiday schedule for a destination country in any year.", "operationId": "world_holidays_year", "parameters": [ { "description": "Country", "in": "query", "name": "country_code", "required": true, "schema": { "type": "string" } }, { "description": "Year", "in": "query", "name": "year", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Holidays by Year", "tags": [ "world", "global", "reference", "time", "lookup", "nager-date", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/holidays/NO/2026", "x-examples": { "Japanese holidays in 2026": "curl https://nordapi.ee/api/v1/holidays/JP/2026", "Norwegian holidays in 2026": "curl https://nordapi.ee/api/v1/holidays/NO/2026", "US holidays in 2027": "curl https://nordapi.ee/api/v1/holidays/US/2027" } } }, "/api/v1/estonian-roads/signs": { "get": { "description": "Current state of 161 electronic variable message signs on Estonian roads. Shows active speed limits, warnings, and when they were last changed.", "operationId": "estonia_ee_variable_signs", "parameters": [ { "description": "Max results (up to 500)", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Variable Message Signs", "tags": [ "estonia", "baltic", "transport", "realtime", "transpordiamet", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-roads/signs?limit=200\"", "x-examples": {} } }, "/api/v1/estonian-sports/organizations": { "get": { "description": "3,539 sports clubs, federations, and schools from spordiregister.ee.", "operationId": "estonia_ee_sports_orgs", "parameters": [ { "description": "Search by name", "in": "query", "name": "q", "required": false, "schema": { "type": "string" } }, { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Sports Organizations", "tags": [ "estonia", "baltic", "sports", "search", "spordiregister", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-sports/organizations?q=jalgpall\"", "x-examples": {} } }, "/api/v1/estonian-health/datasets": { "get": { "description": "List all available health data schemas and tables from TEHIK (Health and Welfare Information Systems Centre). Includes COVID-19, vaccination, and flu datasets.", "operationId": "estonia_ee_health_datasets", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Health Datasets", "tags": [ "estonia", "baltic", "health", "lookup", "tehik", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-health/datasets", "x-examples": {} } }, "/api/v1/rankings": { "get": { "description": "Rank all 30 supported currencies by their daily performance against a chosen base currency. Each entry includes the currency code, current rate, percentage change, and direction (up/down). Ideal for building currency leaderboards, market overview screens, and identifying the day's strongest and weakest currencies at a glance.", "operationId": "finance_rankings", "parameters": [ { "description": "Base currency", "in": "query", "name": "base", "required": false, "schema": { "default": "EUR", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Currency Rankings", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/rankings?base=EUR\"", "x-examples": { "Rankings against EUR (default)": "curl \"https://nordapi.ee/api/v1/rankings?base=EUR\"", "Rankings against NOK": "curl \"https://nordapi.ee/api/v1/rankings?base=NOK\"", "Rankings against USD": "curl \"https://nordapi.ee/api/v1/rankings?base=USD\"" } } }, "/api/v1/earthquakes/nearby": { "get": { "description": "Find earthquakes near a specific location within a configurable radius (default 500 km). Provide latitude and longitude coordinates to search around. Returns matching earthquakes with distance from your point. Useful for location-based safety apps, property risk assessment tools, local seismic activity monitors, and travel apps that inform users about nearby geological activity.", "operationId": "science_earthquakes_nearby", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } }, { "description": "Radius in km", "in": "query", "name": "radius", "required": false, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Nearby Earthquakes", "tags": [ "science", "global", "earthquakes", "search", "earthquakes-usgs", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/earthquakes/nearby?lat=59.9&lon=10.7&radius=500\"", "x-examples": { "Earthquakes near Oslo within 500 km": "curl \"https://nordapi.ee/api/v1/earthquakes/nearby?lat=59.9&lon=10.7&radius=500\"", "Earthquakes near San Francisco within 100 km": "curl \"https://nordapi.ee/api/v1/earthquakes/nearby?lat=37.77&lon=-122.42&radius=100\"", "Earthquakes near Tokyo within 200 km": "curl \"https://nordapi.ee/api/v1/earthquakes/nearby?lat=35.68&lon=139.69&radius=200\"" } } }, "/api/v1/sma": { "get": { "description": "Calculate the Simple Moving Average (SMA) for any currency pair over a configurable number of days (default 30). The SMA smooths out daily rate fluctuations to reveal the underlying trend. Widely used in technical analysis for forex trading signals - when the current rate crosses above or below the SMA, it can indicate trend reversals. Also useful for setting fair exchange rates in business contracts.", "operationId": "finance_sma", "parameters": [ { "description": "Base currency", "in": "query", "name": "base", "required": true, "schema": { "type": "string" } }, { "description": "Target currency", "in": "query", "name": "target", "required": true, "schema": { "type": "string" } }, { "description": "Number of days", "in": "query", "name": "period", "required": false, "schema": { "default": "30", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Moving Average (SMA)", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/sma?base=EUR&target=USD&period=14\"", "x-examples": { "14-day SMA for EUR/USD": "curl \"https://nordapi.ee/api/v1/sma?base=EUR&target=USD&period=14\"", "30-day SMA for USD/NOK (default period)": "curl \"https://nordapi.ee/api/v1/sma?base=USD&target=NOK\"", "7-day SMA for GBP/SEK": "curl \"https://nordapi.ee/api/v1/sma?base=GBP&target=SEK&period=7\"" } } }, "/api/v1/mashup/aquatic/adventure": { "get": { "description": "Water sports recommendation engine: combines marine data (wave height, temperature), weather (wind, precipitation), and air quality to recommend surfing, sailing, kayaking, swimming, or windsurfing.", "operationId": "mashups_aquatic_adventure", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Aquatic Adventure Planner", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/aquatic/adventure?lat=59.4&lon=24.7\"", "x-examples": {} } }, "/api/v1/estonian-roads/traffic": { "get": { "description": "Real-time traffic flow data from 113 detector stations across Estonian roads. Vehicle counts (total and heavy vehicles) and average speeds in both directions. Updated every 15 minutes.", "operationId": "estonia_ee_traffic_flow", "parameters": [ { "description": "Max results (up to 500)", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Traffic Flow", "tags": [ "estonia", "baltic", "transport", "realtime", "transpordiamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-roads/traffic", "x-examples": {} } }, "/api/v1/tallinn/parking": { "get": { "description": "Parking zones (Old Town, City Centre, Downtown, Pirita) with rates, paid hours, free parking rules, payment methods, and electric vehicle info. Sundays are always free.", "operationId": "estonia_tallinn_parking", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Parking Guide", "tags": [ "estonia", "baltic", "transport", "civic", "lookup", "tallinn-life", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/parking", "x-examples": {} } }, "/api/v1/words/rhymes/{word}": { "get": { "description": "Find words that rhyme with the given word. Perfect for poetry generators, songwriting tools, and word games.", "operationId": "language_words_rhymes", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Rhyming Words", "tags": [ "language", "global", "lookup", "datamuse", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/words/rhymes/love", "x-examples": {} } }, "/api/v1/animals/cats/breeds": { "get": { "description": "Get a list of all recognized cat breeds with details like temperament, origin country, life span, and descriptions. Useful for cat breed identification apps, pet adoption platforms, breed comparison features, and veterinary reference tools. Covers all major cat breeds from Abyssinian to Turkish Van.", "operationId": "entertainment_cats_breeds", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cat Breeds", "tags": [ "entertainment", "global", "reference", "lookup", "cat-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/animals/cats/breeds", "x-examples": {} } }, "/api/v1/mashup/ecommerce/price": { "get": { "description": "Calculate international product pricing for e-commerce, combining currency conversion, local VAT/tax rates, and purchasing power parity adjustments. Enter a product price and source currency, specify target countries, and get localized prices with tax included. Useful for SaaS companies setting regional pricing, e-commerce platforms with international customers, and market research tools comparing effective prices across borders.", "operationId": "mashups_ecommerce", "parameters": [ { "description": "Price", "in": "query", "name": "price", "required": true, "schema": { "type": "string" } }, { "description": "Currency", "in": "query", "name": "from_currency", "required": true, "schema": { "type": "string" } }, { "description": "Target countries", "in": "query", "name": "to", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "E-commerce Pricing", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/ecommerce/price?price=99&from_currency=USD&to=DE,JP\"", "x-examples": { "Price a $99 product for Germany and Japan": "curl \"https://nordapi.ee/api/v1/mashup/ecommerce/price?price=99&from_currency=USD&to=DE,JP\"", "Price a EUR 49 product for Nordic markets": "curl \"https://nordapi.ee/api/v1/mashup/ecommerce/price?price=49&from_currency=EUR&to=NO,SE,DK\"", "Price a GBP product for global markets": "curl \"https://nordapi.ee/api/v1/mashup/ecommerce/price?price=29&from_currency=GBP&to=US,DE,JP,AU\"" } } }, "/api/v1/starwars/people/search": { "get": { "description": "Search for Star Wars characters by name across the complete Star Wars universe database. Returns character names, birth years, heights, mass, hair and eye colors, homeworld, and film appearances. Data from SWAPI (Star Wars API) covering all characters from the original and prequel trilogies. Useful for Star Wars fan apps, trivia games, character encyclopedias, and sci-fi entertainment platforms.", "operationId": "entertainment_starwars_search_people", "parameters": [ { "description": "Character name search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Star Wars People Search", "tags": [ "entertainment", "global", "movies", "search", "star-wars-api", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/starwars/people/search?q=luke\"", "x-examples": { "Search for Darth": "curl \"https://nordapi.ee/api/v1/starwars/people/search?q=darth\"", "Search for Leia": "curl \"https://nordapi.ee/api/v1/starwars/people/search?q=leia\"", "Search for Luke": "curl \"https://nordapi.ee/api/v1/starwars/people/search?q=luke\"" } } }, "/api/v1/museum/chicago/search": { "get": { "description": "Search the Art Institute of Chicago's collection of 100,000+ artworks. Returns results with titles, artists, dates, mediums, dimensions, departments, and IIIF image URLs.", "operationId": "art_chicago_search", "parameters": [ { "description": "Search query (e.g. 'impressionism', 'picasso')", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Art Institute of Chicago", "tags": [ "art", "global", "heritage", "search", "artic", "cc-by", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/museum/chicago/search?q=impressionism\"", "x-examples": {} } }, "/api/v1/mashup/aurora/score": { "get": { "description": "Get an aurora borealis viewing score for any location, combining real-time space weather data (Kp index, solar wind) with local weather conditions (cloud cover, light pollution) and geographic latitude. Returns a composite score from 0-100 indicating how likely you are to see the Northern Lights tonight. Ideal for aurora alert apps, tourism platforms in Nordic regions, photography planning tools, and travel apps that help visitors time their trips to see the aurora.", "operationId": "mashups_aurora", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": false, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": false, "schema": { "type": "string" } }, { "description": "City name (alternative to lat/lon)", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Aurora Viewing Score", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/aurora/score?city=tallinn\"", "x-examples": { "Aurora score for Oslo": "curl \"https://nordapi.ee/api/v1/mashup/aurora/score?city=oslo\"", "Aurora score for Reykjavik": "curl \"https://nordapi.ee/api/v1/mashup/aurora/score?city=reykjavik\"", "Aurora score for Tallinn": "curl \"https://nordapi.ee/api/v1/mashup/aurora/score?city=tallinn\"", "Aurora score for Tromso by coordinates": "curl \"https://nordapi.ee/api/v1/mashup/aurora/score?lat=69.65&lon=18.96\"" } } }, "/api/v1/dnd/spells": { "get": { "description": "Browse all spells from the D&D 5th Edition System Reference Document. Returns spell names and index keys for the full SRD spell catalog. Covers iconic spells like Fireball, Magic Missile, and Wish. Data from the open D&D 5e API. Useful for spellbook builders, character creation wizards, spell reference apps, and tabletop RPG planning tools.", "operationId": "entertainment_dnd_spells", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "D&D Spell List", "tags": [ "entertainment", "global", "games", "lookup", "dnd5e-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/dnd/spells", "x-examples": { "Browse the spell compendium": "curl https://nordapi.ee/api/v1/dnd/spells", "List all D&D spells": "curl https://nordapi.ee/api/v1/dnd/spells" } } }, "/api/v1/games/deal/{id}": { "get": { "description": "Get full details about a specific game deal including price history and store info.", "operationId": "gaming_game_deal", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Deal Details", "tags": [ "gaming", "global", "games", "lookup", "cheapshark", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/games/deal/example-deal-id", "x-examples": {} } }, "/api/v1/airquality/forecast": { "get": { "description": "Get a 3-day hourly air quality forecast for any location, including predicted PM2.5, PM10, ozone, and AQI levels. Useful for planning outdoor activities, warning vulnerable populations about upcoming poor air quality days, and building proactive health notification systems. Data from Open-Meteo forecast models.", "operationId": "geo_airquality_forecast", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Air Quality Forecast", "tags": [ "geo", "global", "weather", "environment", "realtime", "open-meteo", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/airquality/forecast?lat=59.9&lon=10.7\"", "x-examples": { "Air quality forecast for Delhi": "curl \"https://nordapi.ee/api/v1/airquality/forecast?lat=28.61&lon=77.21\"", "Air quality forecast for London": "curl \"https://nordapi.ee/api/v1/airquality/forecast?lat=51.51&lon=-0.13\"", "Air quality forecast for Oslo": "curl \"https://nordapi.ee/api/v1/airquality/forecast?lat=59.9&lon=10.7\"" } } }, "/api/v1/animals/dogs/breeds": { "get": { "description": "Get a complete list of all recognized dog breeds with sub-breeds where applicable. Returns breed names organized hierarchically. Useful for dog breed identification apps, pet adoption platforms, breed comparison tools, and veterinary reference applications. Data from the Dog CEO API covering 100+ breeds.", "operationId": "entertainment_dogs_breeds", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Dog Breeds", "tags": [ "entertainment", "global", "reference", "lookup", "dog-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/animals/dogs/breeds", "x-examples": {} } }, "/api/v1/electricity/today/{zone}": { "get": { "description": "Get all 24 hourly electricity spot prices for today in a specific Nordic bidding zone. Returns each hour's price in EUR/MWh, making it easy to find the cheapest and most expensive hours of the day. Critical for smart home systems that schedule energy-intensive tasks (laundry, dishwasher, EV charging) during the cheapest hours, and for energy dashboards showing the full daily price curve. Data from Nord Pool.", "operationId": "electricity_today", "parameters": [ { "description": "Zone code", "in": "path", "name": "zone", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Today's Prices", "tags": [ "electricity", "global", "nordic", "power", "realtime", "hvakosterstrommen", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/electricity/today/SE3", "x-examples": { "Today's hourly prices in Oslo (NO1)": "curl https://nordapi.ee/api/v1/electricity/today/NO1", "Today's hourly prices in Stockholm (SE3)": "curl https://nordapi.ee/api/v1/electricity/today/SE3" } } }, "/api/v1/spaceweather/flares": { "get": { "description": "Get recent solar flare events from NOAA SWPC, including flare class (A, B, C, M, X), peak time, begin/end times, and source active region. M-class and X-class flares can cause radio blackouts, GPS disruptions, and enhanced aurora displays. Useful for amateur radio operators monitoring propagation conditions, aurora forecasters, space weather researchers, and satellite operators assessing radiation risk.", "operationId": "science_spaceweather_flares", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Solar Flare Activity", "tags": [ "science", "global", "geomagnetic", "space", "realtime", "noaa-swpc", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/spaceweather/flares", "x-examples": {} } }, "/api/v1/pokemon": { "get": { "description": "Browse all 1,000+ Pokemon from the complete National Pokedex. Returns names, IDs, and sprite image URLs. Paginated for easy browsing. Data from PokeAPI covering all generations from Red/Blue to Scarlet/Violet.", "operationId": "entertainment_pokemon_list", "parameters": [ { "description": "Pokemon per page (max 100)", "in": "path", "name": "limit", "required": true, "schema": { "default": "20", "type": "string" } }, { "description": "Starting position", "in": "query", "name": "offset", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "List Pokemon", "tags": [ "entertainment", "global", "games", "lookup", "pokeapi", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/pokemon?limit=10\"", "x-examples": { "First 20 Pokemon": "curl https://nordapi.ee/api/v1/pokemon", "First 5 starter region": "curl \"https://nordapi.ee/api/v1/pokemon?limit=5\"", "Pokemon 51-100": "curl \"https://nordapi.ee/api/v1/pokemon?limit=50&offset=50\"" } } }, "/api/v1/github/trending": { "get": { "description": "Get the currently trending repositories on GitHub - the projects gaining the most stars and attention right now. Returns repo names, descriptions, star counts, languages, and authors. Useful for developer dashboards, 'what's hot in open source' features, tech newsletters, and staying current with the developer community's latest interests.", "operationId": "news_github_trending", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Trending Repos", "tags": [ "news", "global", "social", "realtime", "github", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/github/trending", "x-examples": {} } }, "/api/v1/riha/system/{name}": { "get": { "description": "Get full details of a specific government IT system by its short name. Returns complete metadata including legislation, data files, stored data descriptions, and technical documentation.", "operationId": "estonia_riha_system", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian IT System Detail", "tags": [ "estonia", "baltic", "reference", "civic", "lookup", "riha", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/riha/system/74000234-amphora", "x-examples": {} } }, "/api/v1/tallinn/webcams": { "get": { "description": "Overview of all camera systems in Estonia: 255 Tallinn traffic cameras, 182 national road cameras, and 42 public webcams. Shows endpoints, sources, and image URL patterns. For the full webcam registry with direct image/stream URLs, use /estonian-webcams.", "operationId": "estonia_tallinn_webcams", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Camera Systems Directory", "tags": [ "estonia", "baltic", "cameras", "lookup", "tallinn-cameras", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/webcams", "x-examples": {} } }, "/api/v1/estonian-museums": { "get": { "description": "Browse 70 Estonian museums scraped from muis.ee.", "operationId": "estonia_ee_museums", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Museums", "tags": [ "estonia", "baltic", "heritage", "lookup", "muis", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-museums", "x-examples": {} } }, "/api/v1/nasa/mars": { "get": { "description": "Browse photos taken by NASA's Curiosity rover on Mars, organized by Martian sol (solar day). Returns image URLs, camera names, and earth dates for each photo. Specify a sol number to browse different days of the mission. Useful for space exploration apps, educational content, Mars visualization projects, and anyone who wants to see the surface of another planet through real NASA cameras.", "operationId": "science_nasa_mars", "parameters": [ { "description": "Martian sol day", "in": "query", "name": "sol", "required": false, "schema": { "default": "1000", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Mars Rover Photos", "tags": [ "science", "global", "space", "astronomy", "lookup", "nasa", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/nasa/mars?sol=1000\"", "x-examples": { "Photos from sol 1000 (default)": "curl \"https://nordapi.ee/api/v1/nasa/mars?sol=1000\"", "Photos from sol 3000": "curl \"https://nordapi.ee/api/v1/nasa/mars?sol=3000\"", "Photos from the first sol": "curl \"https://nordapi.ee/api/v1/nasa/mars?sol=1\"" } } }, "/api/v1/elections/ee/{election}/files": { "get": { "description": "List all data files for an election: results XML, candidate lists, participation info, polling station locations. Direct download URLs included.", "operationId": "estonia_elections_files", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Election Data Files", "tags": [ "estonia", "baltic", "elections", "civic", "lookup", "valimised", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/elections/ee/KOV_2025/files", "x-examples": {} } }, "/api/v1/words/autocomplete/{prefix}": { "get": { "description": "Get word suggestions for a given prefix. Ideal for search-as-you-type and autocomplete interfaces.", "operationId": "language_words_autocomplete", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Autocomplete", "tags": [ "language", "global", "lookup", "datamuse", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/words/autocomplete/prog", "x-examples": {} } }, "/api/v1/carbon/compare": { "get": { "description": "Compare CO2 emissions per capita across multiple countries side by side. Provide a comma-separated list of country codes to see how they stack up. Returns per-capita and total emission data for each country. Ideal for building comparison charts, climate policy analysis tools, and educational content about global emission disparities between nations.", "operationId": "science_carbon_compare", "parameters": [ { "description": "Comma-separated codes", "in": "query", "name": "countries", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Compare Emissions", "tags": [ "science", "global", "environment", "statistics", "lookup", "world-bank", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/carbon/compare?countries=NO,US,CN\"", "x-examples": { "Compare Nordic countries": "curl \"https://nordapi.ee/api/v1/carbon/compare?countries=NO,SE,DK,FI\"", "Compare Norway, US, and China": "curl \"https://nordapi.ee/api/v1/carbon/compare?countries=NO,US,CN\"", "Compare major economies": "curl \"https://nordapi.ee/api/v1/carbon/compare?countries=US,CN,DE,JP,GB,IN\"" } } }, "/api/v1/estonian-power/outages/history": { "get": { "description": "Per-area snapshots of Estonian Elektrilevi outages, sampled every 5 minutes. Returns unplanned/planned outage counts and affected customers per area per snapshot. Filter by ?area_id and ?start/?end. Useful for computing regional reliability metrics, ranking areas by outage frequency, and building long-term infrastructure dashboards.", "operationId": "estonia_ee_power_outages_history", "parameters": [ { "description": "Elektrilevi area ID", "in": "path", "name": "area_id", "required": true, "schema": { "type": "string" } }, { "description": "Start datetime", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Power Outages Area History", "tags": [ "estonia", "baltic", "power", "snapshot-history", "elektrilevi", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-power/outages/history?limit=288\"", "x-examples": {} } }, "/api/v1/spaceweather/alerts/history": { "get": { "description": "Archive of issued NOAA SWPC alerts: geomagnetic storm watches, solar radiation storms, radio blackout warnings, and more. Filter by ?start and ?end. Ideal for post-mortems on specific events, training data for alert prediction models, and historical context when an alert fires today.", "operationId": "science_spaceweather_alerts_history", "parameters": [ { "description": "Start datetime", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Space Weather Alert History", "tags": [ "science", "global", "geomagnetic", "space", "snapshot-history", "noaa-swpc", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/spaceweather/alerts/history?limit=100\"", "x-examples": {} } }, "/api/v1/animals/dogs/{breed}": { "get": { "description": "Get random images specifically for a chosen dog breed (e.g., husky, labrador, poodle). Returns image URLs for the requested breed. Useful for breed-specific gallery features, dog breed education pages, and pet matchmaking apps where users want to see what a particular breed looks like. Data from the Dog CEO API.", "operationId": "entertainment_dogs_breed", "parameters": [ { "description": "Breed name", "in": "query", "name": "breed", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Dogs by Breed", "tags": [ "entertainment", "global", "lookup", "dog-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/animals/dogs/husky", "x-examples": { "Husky photos": "curl https://nordapi.ee/api/v1/animals/dogs/husky", "Labrador photos": "curl https://nordapi.ee/api/v1/animals/dogs/labrador", "Poodle photos": "curl https://nordapi.ee/api/v1/animals/dogs/poodle" } } }, "/api/v1/stream": { "get": { "description": "Connect to a Server-Sent Events stream for real-time push updates. Subscribe to broad topics or filter to specific items using the topic:filter syntax. Events include unique IDs for reconnection (pass Last-Event-ID header to resume). Heartbeat keeps the connection alive. Use curl -N or JavaScript EventSource. 14 topics available: exchange rates, crypto, electricity, commodities, economics, holidays, weather, earthquakes, space weather, NASA, sports, news, VAT, and currencies.", "operationId": "tools_stream", "parameters": [ { "description": "Comma-separated subscriptions with optional filters (e.g. crypto:bitcoin,electricity:NO1)", "in": "query", "name": "topics", "required": true, "schema": { "type": "string" } }, { "description": "Heartbeat interval in seconds (5-300)", "in": "query", "name": "heartbeat", "required": false, "schema": { "default": "30", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Real-Time Data Stream (SSE)", "tags": [ "tools", "global", "realtime", "internal", "open", "none" ], "x-example": "curl -N \"https://nordapi.ee/api/v1/stream?topics=crypto:bitcoin,electricity:NO1\"", "x-examples": { "All Nordic electricity with fast heartbeat": "curl -N \"https://nordapi.ee/api/v1/stream?topics=electricity&heartbeat=15\"", "EUR/USD and gold": "curl -N \"https://nordapi.ee/api/v1/stream?topics=exchange_rates:EUR/USD,commodities:gold\"", "Everything crypto and commodities": "curl -N \"https://nordapi.ee/api/v1/stream?topics=crypto,commodities\"", "NOK exchange rates only": "curl -N \"https://nordapi.ee/api/v1/stream?topics=exchange_rates:NOK\"", "Only Bitcoin price updates": "curl -N \"https://nordapi.ee/api/v1/stream?topics=crypto:bitcoin\"", "Only Oslo electricity zone": "curl -N \"https://nordapi.ee/api/v1/stream?topics=electricity:NO1\"" } } }, "/api/v1/estonian-research/researchers": { "get": { "description": "Browse 19,463 researchers from the Estonian Research Information System (ETIS). Returns first name, last name, CV URL, and ETIS ID. Paginated alphabetically. Use the researcher detail endpoint with the ID to get full CV data. Available in English and Estonian.", "operationId": "estonia_ee_researchers", "parameters": [ { "description": "Language: ENG or EST", "in": "query", "name": "lang", "required": false, "schema": { "default": "ENG", "type": "string" } }, { "description": "Results per page (max 100)", "in": "path", "name": "limit", "required": true, "schema": { "default": "25", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "1", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Researchers", "tags": [ "estonia", "baltic", "research", "reference", "search", "etis", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-research/researchers", "x-examples": {} } }, "/api/v1/estonian-health/vaccination": { "get": { "description": "Vaccination coverage data by county, age group, and gender for various diseases in Estonia.", "operationId": "estonia_ee_vaccination", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } }, { "description": "Offset", "in": "query", "name": "offset", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Vaccination Coverage", "tags": [ "estonia", "baltic", "health", "lookup", "tehik", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-health/vaccination?limit=10\"", "x-examples": {} } }, "/api/v1/tallinn/emergency": { "get": { "description": "Emergency contacts, police stations, hospitals with addresses and phone numbers, poison control, crisis helpline, and child helpline for Tallinn.", "operationId": "estonia_tallinn_emergency", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Emergency Services", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-info", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/emergency", "x-examples": {} } }, "/api/v1/estonian-monuments/types": { "get": { "description": "List all available monument types and counts.", "operationId": "estonia_ee_monument_types", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Monument Types", "tags": [ "estonia", "baltic", "heritage", "lookup", "register-muinas", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-monuments/types", "x-examples": {} } }, "/api/v1/nobel/laureates": { "get": { "description": "Search Nobel Prize laureates by name or birth country. Returns laureate biographies, prize categories, years awarded, and motivations. Data from the Nobel Foundation. Useful for building searchable laureate databases, country-specific Nobel winner lists, and educational tools exploring scientific and literary achievement.", "operationId": "world_nobel_laureates", "parameters": [ { "description": "Name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } }, { "description": "Birth country", "in": "query", "name": "country", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Nobel Laureates", "tags": [ "world", "global", "reference", "science", "search", "nobel", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/nobel/laureates?name=Einstein\"", "x-examples": { "Laureates from Japan": "curl \"https://nordapi.ee/api/v1/nobel/laureates?country=Japan\"", "Laureates from Norway": "curl \"https://nordapi.ee/api/v1/nobel/laureates?country=Norway\"", "Search for Einstein": "curl \"https://nordapi.ee/api/v1/nobel/laureates?name=Einstein\"" } } }, "/api/v1/pokemon/type/{type}": { "get": { "description": "Get all Pokemon of a specific type (fire, water, electric, etc.) with type effectiveness data. Returns which types it's strong against, weak against, and immune to. Useful for team building and battle strategy tools.", "operationId": "entertainment_pokemon_type", "parameters": [ { "description": "Pokemon type (fire, water, electric, grass, etc.)", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Pokemon by Type", "tags": [ "entertainment", "global", "games", "lookup", "pokeapi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/pokemon/type/fire", "x-examples": { "All Dragon-type Pokemon": "curl https://nordapi.ee/api/v1/pokemon/type/dragon", "All Electric-type Pokemon": "curl https://nordapi.ee/api/v1/pokemon/type/electric", "All Fire-type Pokemon": "curl https://nordapi.ee/api/v1/pokemon/type/fire" } } }, "/api/v1/tallinn/data/city-plans": { "get": { "description": "Detailed and thematic city planning data from the Tallinn Planning Register.", "operationId": "estonia_tallinn_city_plans", "parameters": [ { "description": "Results per page", "in": "query", "name": "per_page", "required": false, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn City Plans", "tags": [ "estonia", "baltic", "civic", "environment", "lookup", "avaandmed-tallinn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/data/city-plans", "x-examples": {} } }, "/api/v1/estonian-auctions/classifiers/{type}": { "get": { "description": "Lookup tables for auction types, land purposes, and other classifications.", "operationId": "estonia_ee_auctions_classifiers", "parameters": [ { "description": "Classifier type (e.g. LAND_PURPOSE, AUCTION_TYPE)", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Auction Classifiers", "tags": [ "estonia", "baltic", "business", "civic", "lookup", "riigimaaoksjon", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-auctions/classifiers/LAND_PURPOSE", "x-examples": {} } }, "/api/v1/estonian-stats/population": { "get": { "description": "Population statistics for Estonia including population count, area, and density by county. Data from Statistics Estonia's official PxWeb database.", "operationId": "estonia_stats_population", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Population Data", "tags": [ "estonia", "baltic", "statistics", "lookup", "statistikaamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-stats/population", "x-examples": {} } }, "/api/v1/estonian-misc": { "get": { "description": "Index of additional Estonian data sources: road register, internet coverage map, council meeting systems.", "operationId": "estonia_ee_misc", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Misc Estonian Registries Index", "tags": [ "estonia", "baltic", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-misc", "x-examples": {} } }, "/api/v1/marine/current": { "get": { "description": "Get current ocean conditions for any coastal or open-water location, including wave height, wave direction, wave period, and swell data. Requires latitude and longitude coordinates. Essential for marine navigation apps, surfing and water sports planners, fishing trip tools, offshore operations dashboards, and coastal safety systems. Data from Open-Meteo marine models.", "operationId": "geo_marine_current", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Current Marine Data", "tags": [ "geo", "global", "weather", "realtime", "open-meteo", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/marine/current?lat=59.9&lon=10.7\"", "x-examples": { "Marine conditions in Oslo Fjord": "curl \"https://nordapi.ee/api/v1/marine/current?lat=59.9&lon=10.7\"", "Ocean conditions off Cornwall": "curl \"https://nordapi.ee/api/v1/marine/current?lat=50.27&lon=-5.05\"", "Wave data near Honolulu": "curl \"https://nordapi.ee/api/v1/marine/current?lat=21.31&lon=-157.86\"" } } }, "/api/v1/estonian-research/publications": { "get": { "description": "Browse 324,782 academic publications from Estonian researchers in the ETIS system. Includes title, authors, publishing year, publication type, and open access status. Paginated chronologically.", "operationId": "estonia_ee_publications", "parameters": [ { "description": "Language: ENG or EST", "in": "query", "name": "lang", "required": false, "schema": { "default": "ENG", "type": "string" } }, { "description": "Results per page (max 100)", "in": "path", "name": "limit", "required": true, "schema": { "default": "25", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "1", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Publications", "tags": [ "estonia", "baltic", "research", "reference", "lookup", "etis", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-research/publications", "x-examples": {} } }, "/api/v1/news/wikipedia": { "get": { "description": "Get Wikipedia's featured content for today (or a specified date), including the featured article, 'on this day' historical events, notable birthdays, and picture of the day. Returns rich content with summaries and thumbnail images. Useful for educational apps, daily knowledge features, trivia tools, and content platforms that want to surface interesting encyclopedia content. Data from the Wikimedia REST API.", "operationId": "news_wikipedia", "parameters": [ { "description": "Date", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Wikipedia Featured", "tags": [ "news", "global", "reference", "scheduled", "wikipedia", "cc-by", "none" ], "x-example": "curl https://nordapi.ee/api/v1/news/wikipedia", "x-examples": { "Today's featured Wikipedia content": "curl https://nordapi.ee/api/v1/news/wikipedia", "Wikipedia content from a specific date": "curl \"https://nordapi.ee/api/v1/news/wikipedia?date=2026-01-01\"" } } }, "/api/v1/mashup/cultural/moment": { "get": { "description": "Generate a unique cultural snapshot for any city: combines current weather, a random museum artwork, a random classic poem, elevation data, light pollution levels, and sunrise/sunset times into an atmospheric moment. Perfect for creative apps, daily inspiration features, and cultural tourism tools.", "operationId": "mashups_cultural_moment", "parameters": [ { "description": "City name (e.g. oslo, paris, tokyo)", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cultural Moment", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/cultural/moment?city=paris\"", "x-examples": {} } }, "/api/v1/mashup/border/intelligence": { "get": { "description": "Estonia-Russia border crossing intelligence: current queue times combined with weather at the border, upcoming holidays in both countries that affect traffic, and optimal crossing tips.", "operationId": "mashups_border_intelligence", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Border Queue Intelligence", "tags": [ "mashups" ], "x-example": "curl https://nordapi.ee/api/v1/mashup/border/intelligence", "x-examples": {} } }, "/api/v1/news/hackernews/top": { "get": { "description": "Get the current top stories from Hacker News, ranked by the HN ranking algorithm (a combination of votes and recency). Returns story titles, URLs, scores, comment counts, and authors. Configurable limit (default 20). Essential for developer news feeds, tech dashboards, and startup community tools. Data fetched in real-time from the official Hacker News Firebase API.", "operationId": "news_hn_top", "parameters": [ { "description": "Limit", "in": "path", "name": "limit", "required": true, "schema": { "default": "20", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "HN Top Stories", "tags": [ "news", "global", "social", "realtime", "hacker-news", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/news/hackernews/top", "x-examples": { "Top 20 HN stories (default)": "curl https://nordapi.ee/api/v1/news/hackernews/top", "Top 5 HN stories": "curl \"https://nordapi.ee/api/v1/news/hackernews/top?limit=5\"", "Top 50 HN stories": "curl \"https://nordapi.ee/api/v1/news/hackernews/top?limit=50\"" } } }, "/api/v1/health/indicators": { "get": { "description": "List all available World Health Organization health indicators, including life expectancy, infant mortality, immunization rates, disease prevalence, healthcare spending, and more. Use this endpoint to discover which health metrics are available before querying specific indicator data. Data sourced from the WHO Global Health Observatory.", "operationId": "world_health_indicators", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "WHO Health Indicators", "tags": [ "world", "global", "health", "reference", "lookup", "who", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/health/indicators", "x-examples": {} } }, "/api/v1/randomuser": { "get": { "description": "Generate a realistic random user profile from the RandomUser.me API, a popular service for generating fake user data. Returns a complete user identity including name, email, phone, address (street, city, state, country, postcode), date of birth, age, profile picture URLs (thumbnail, medium, large), login credentials (username, password), nationality, and a unique ID. Unlike the /generate/user endpoint which generates simple profiles locally, this endpoint produces richer, more realistic data with actual profile photos. Ideal for UI prototyping, populating demo environments, testing user registration flows, and creating realistic mockup data for presentations.", "operationId": "tools_randomuser", "parameters": [ { "description": "Filter by gender (male or female)", "in": "query", "name": "gender", "required": false, "schema": { "type": "string" } }, { "description": "Nationality code (e.g., US, GB, NO, FI, DK)", "in": "query", "name": "nat", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random User Generator", "tags": [ "tools", "global", "generators", "computed", "randomuser", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/randomuser", "x-examples": { "Generate a Danish user": "curl \"https://nordapi.ee/api/v1/randomuser?nat=DK\"", "Generate a Norwegian user": "curl \"https://nordapi.ee/api/v1/randomuser?nat=NO\"", "Generate a female user from Finland": "curl \"https://nordapi.ee/api/v1/randomuser?gender=female&nat=FI\"", "Generate a random user": "curl https://nordapi.ee/api/v1/randomuser" } } }, "/api/v1/fun/quote/today": { "get": { "description": "Get today's featured quote of the day - the same quote for everyone throughout the entire day, changing at midnight. Unlike the random quote endpoint, this provides a consistent daily quote suitable for shared experiences. Perfect for daily digest emails, morning notification features, shared office displays, and social apps where all users see the same daily inspiration.", "operationId": "entertainment_fun_qotd", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Quote of the Day", "tags": [ "entertainment", "global", "scheduled", "zenquotes", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/fun/quote/today", "x-examples": {} } }, "/api/v1/music/artist/{id}": { "get": { "description": "Get detailed information about a specific music artist by their Deezer ID, including name, fan count, album count, top tracks, and artist image. Useful for building artist profile pages, discography browsers, and music recommendation features that need detailed artist metadata.", "operationId": "entertainment_music_artist", "parameters": [ { "description": "Artist ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Artist Detail", "tags": [ "entertainment", "global", "music", "lookup", "deezer", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/music/artist/1", "x-examples": { "Artist with ID 1": "curl https://nordapi.ee/api/v1/music/artist/1", "Daft Punk artist profile": "curl https://nordapi.ee/api/v1/music/artist/27", "Eminem artist profile": "curl https://nordapi.ee/api/v1/music/artist/13" } } }, "/api/v1/countries": { "get": { "description": "Get all 49 countries supported by the currency system, each with their ISO country code, full name, official currency code, geographic region, and flag emoji. Optionally filter by region (e.g., Europe, Asia). Useful for building country selectors in currency apps, mapping which countries use which currencies, and populating geo-filtered dropdowns.", "operationId": "finance_countries", "parameters": [ { "description": "Filter by region", "in": "query", "name": "region", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "List Countries", "tags": [ "finance", "global", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/countries", "x-examples": { "All countries (no filter)": "curl \"https://nordapi.ee/api/v1/countries\"", "Asian countries only": "curl \"https://nordapi.ee/api/v1/countries?region=Asia\"", "European countries only": "curl \"https://nordapi.ee/api/v1/countries?region=Europe\"" } } }, "/api/v1/vat/calculate": { "get": { "description": "Calculate the VAT amount and total price (net + VAT) for a given amount and country. Automatically applies the correct VAT rate for the specified EU/EEA country. Optionally converts the total into another currency using live exchange rates. Perfect for building pricing calculators, checkout summaries, and invoice generators that need to show net amount, VAT, and total in the customer's preferred currency.", "operationId": "finance_vat_calculate", "parameters": [ { "description": "Net amount", "in": "query", "name": "amount", "required": true, "schema": { "type": "string" } }, { "description": "Country code", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } }, { "description": "Convert total to currency", "in": "query", "name": "currency", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "VAT Calculator", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/vat/calculate?amount=100&country=DE¤cy=USD\"", "x-examples": { "Calculate French VAT converted to GBP": "curl \"https://nordapi.ee/api/v1/vat/calculate?amount=250&country=FR¤cy=GBP\"", "Calculate German VAT with USD conversion": "curl \"https://nordapi.ee/api/v1/vat/calculate?amount=100&country=DE¤cy=USD\"", "Calculate Norwegian VAT on a product": "curl \"https://nordapi.ee/api/v1/vat/calculate?amount=499&country=NO\"" } } }, "/api/v1/estonian-misc/{name}": { "get": { "description": "Get detail for a specific misc registry by name.", "operationId": "estonia_ee_misc_show", "parameters": [ { "description": "Registry name (teeregister, netikaart, volis)", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Misc Registry Detail", "tags": [ "estonia", "baltic", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-misc/teeregister", "x-examples": {} } }, "/api/v1/museum/met/search": { "get": { "description": "Search the Metropolitan Museum of Art's collection of 470,000+ artworks by keyword. Returns matching artworks with titles, artists, dates, mediums, departments, and image URLs. The Met's collection spans 5,000 years of world culture.", "operationId": "art_met_search", "parameters": [ { "description": "Search query (e.g. 'monet', 'egyptian', 'armor')", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Met Museum", "tags": [ "art", "global", "heritage", "search", "met-museum", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/museum/met/search?q=monet\"", "x-examples": {} } }, "/api/v1/health/{indicator}": { "get": { "description": "Get data for a specific WHO health indicator, optionally filtered by country. Returns values with year and country breakdown. Covers metrics like life expectancy, maternal mortality, vaccination coverage, disease incidence, and healthcare expenditure. Useful for global health dashboards, development research, country comparison tools, and public health reporting applications.", "operationId": "world_health_show", "parameters": [ { "description": "Indicator key", "in": "query", "name": "indicator", "required": true, "schema": { "type": "string" } }, { "description": "Country code", "in": "query", "name": "country", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Health Indicator Data", "tags": [ "world", "global", "health", "statistics", "lookup", "who", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/health/life_expectancy", "x-examples": { "Infant mortality for all countries": "curl https://nordapi.ee/api/v1/health/infant_mortality", "Life expectancy data worldwide": "curl https://nordapi.ee/api/v1/health/life_expectancy", "Life expectancy for Norway": "curl \"https://nordapi.ee/api/v1/health/life_expectancy?country=NO\"" } } }, "/api/v1/weather/current": { "get": { "description": "Get current weather conditions for any location, including temperature, humidity, feels-like temperature, precipitation, wind speed and direction, and weather description code. Supports lookup by latitude/longitude coordinates or by city name (30 major cities supported). Data updated every 15 minutes from Open-Meteo, powered by national weather services. Ideal for weather widgets, outdoor activity planners, and location-based apps.", "operationId": "geo_weather_current", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": false, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": false, "schema": { "type": "string" } }, { "description": "City name", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Current Weather", "tags": [ "geo", "global", "weather", "realtime", "open-meteo", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/weather/current?city=oslo\"", "x-examples": { "Weather by coordinates (New York)": "curl \"https://nordapi.ee/api/v1/weather/current?lat=40.71&lon=-74.01\"", "Weather in Oslo by city name": "curl \"https://nordapi.ee/api/v1/weather/current?city=oslo\"", "Weather in Tokyo by city name": "curl \"https://nordapi.ee/api/v1/weather/current?city=tokyo\"" } } }, "/api/v1/advice/random": { "get": { "description": "Get a random piece of advice. Great for chatbots, daily widgets, and inspiration apps.", "operationId": "texttools_advice_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Advice", "tags": [ "texttools", "global", "text", "reference", "lookup", "advice-slip", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/advice/random", "x-examples": {} } }, "/api/v1/starwars/starships/{id}": { "get": { "description": "Get detailed specifications for a specific Star Wars starship by its SWAPI ID. Returns the ship's name, model, manufacturer, cost in credits, length, crew size, passenger capacity, cargo capacity, consumables duration, hyperdrive rating, MGLT speed, and starship class. Useful for Star Wars technical databases, ship comparison tools, and sci-fi fleet management games.", "operationId": "entertainment_starwars_starship", "parameters": [ { "description": "SWAPI starship ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Star Wars Starship Detail", "tags": [ "entertainment", "global", "movies", "lookup", "star-wars-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/starwars/starships/9", "x-examples": { "Death Star (ID 9)": "curl https://nordapi.ee/api/v1/starwars/starships/9", "Millennium Falcon (ID 10)": "curl https://nordapi.ee/api/v1/starwars/starships/10", "X-wing (ID 12)": "curl https://nordapi.ee/api/v1/starwars/starships/12" } } }, "/api/v1/riigikogu/votings/recent": { "get": { "description": "Get recent parliamentary voting records from the last N days (default 30). Convenience endpoint that wraps the date range query.", "operationId": "estonia_riigikogu_recent", "parameters": [ { "description": "Number of days to look back", "in": "query", "name": "days", "required": false, "schema": { "default": "30", "type": "string" } }, { "description": "Language: en or et", "in": "query", "name": "lang", "required": false, "schema": { "default": "en", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Recent Riigikogu Votings", "tags": [ "estonia", "baltic", "civic", "legal", "lookup", "riigikogu", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/riigikogu/votings/recent", "x-examples": {} } }, "/api/v1/estonian-research/projects": { "get": { "description": "Browse 25,917 research projects funded in Estonia from the ETIS system. Includes project name, responsible executor, institution, and funding details. Paginated.", "operationId": "estonia_ee_projects", "parameters": [ { "description": "Language: ENG or EST", "in": "query", "name": "lang", "required": false, "schema": { "default": "ENG", "type": "string" } }, { "description": "Results per page (max 100)", "in": "path", "name": "limit", "required": true, "schema": { "default": "25", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "1", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Research Projects", "tags": [ "estonia", "baltic", "research", "reference", "lookup", "etis", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-research/projects", "x-examples": {} } }, "/api/v1/spaceweather/alerts": { "get": { "description": "Get current space weather alerts and warnings from NOAA's Space Weather Prediction Center (SWPC). Returns active geomagnetic storm watches, solar radiation storms, radio blackout alerts, and other space weather advisories. Each alert includes severity level, issue time, and description. Essential for aurora chasers, satellite operators, aviation planners, and power grid managers who need to monitor geomagnetic disturbances.", "operationId": "science_spaceweather_alerts", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Space Weather Alerts", "tags": [ "science", "global", "geomagnetic", "space", "realtime", "noaa-swpc", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/spaceweather/alerts", "x-examples": {} } }, "/api/v1/commodities": { "get": { "description": "Get the latest spot prices for 7 major commodities: gold, silver, platinum, palladium, crude oil, natural gas, and copper. Prices are in USD by default but can be converted to any of the 30 supported currencies. Useful for commodity trading dashboards, investment portfolio trackers, and economic analysis tools that need to monitor raw material prices alongside currencies.", "operationId": "finance_commodities", "parameters": [ { "description": "Price currency", "in": "query", "name": "currency", "required": false, "schema": { "default": "USD", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "All Commodities", "tags": [ "finance", "global", "commodities", "realtime", "frankfurter", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/commodities", "x-examples": { "All commodities in EUR": "curl \"https://nordapi.ee/api/v1/commodities?currency=EUR\"", "All commodities in Norwegian Krone": "curl \"https://nordapi.ee/api/v1/commodities?currency=NOK\"", "All commodities in USD (default)": "curl \"https://nordapi.ee/api/v1/commodities\"" } } }, "/api/v1/countrydata/search": { "get": { "description": "Search countries by name with fuzzy matching. Returns full country profiles for each match, including capital, population, region, languages, and currency. Useful for building autocomplete country search fields and location pickers where users might type partial or approximate country names.", "operationId": "geo_countrydata_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Countries", "tags": [ "geo", "global", "geography", "reference", "search", "rest-countries", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/countrydata/search?q=norway\"", "x-examples": { "Search for Norway": "curl \"https://nordapi.ee/api/v1/countrydata/search?q=norway\"", "Search for countries with 'united'": "curl \"https://nordapi.ee/api/v1/countrydata/search?q=united\"", "Search for island nations": "curl \"https://nordapi.ee/api/v1/countrydata/search?q=island\"" } } }, "/api/v1/estonian-roads/services": { "get": { "description": "List all 40+ available map data layers from the Transport Administration ArcGIS server. Includes road cameras, speed cameras, weather stations, bikeways, bridges, truck routes, ice roads, parking, and more.", "operationId": "estonia_ee_road_services", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Road Data Services", "tags": [ "estonia", "baltic", "transport", "lookup", "transpordiamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-roads/services", "x-examples": {} } }, "/api/v1/cards/new": { "get": { "description": "Create a new shuffled deck of playing cards. Returns a deck ID for use with draw and shuffle endpoints.", "operationId": "gaming_cards_new", "parameters": [ { "description": "Number of decks to combine", "in": "query", "name": "deck_count", "required": false, "schema": { "default": "1", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "New Card Deck", "tags": [ "gaming", "global", "games", "computed", "deck-of-cards", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/cards/new", "x-examples": {} } }, "/api/v1/mashup/congress/signals": { "get": { "description": "Aggregate and analyze recent stock trades disclosed by US Congress members (both Senate and House), combining trade data with current stock prices and market sentiment. Identifies the most actively traded stocks by lawmakers, unusual trading patterns, and potential signal value. Returns a summary of recent congressional trading activity with buy/sell ratios and top traded tickers. Useful for alternative investment research, political finance analysis tools, and transparency platforms tracking insider-like trading by elected officials.", "operationId": "mashups_congress_signals", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Congress Trading Signals", "tags": [ "mashups" ], "x-example": "curl https://nordapi.ee/api/v1/mashup/congress/signals", "x-examples": { "Get current congressional trading signals": "curl https://nordapi.ee/api/v1/mashup/congress/signals" } } }, "/api/v1/riha/stats": { "get": { "description": "Quick statistics on Estonia's government IT infrastructure: total registered systems and active systems count.", "operationId": "estonia_riha_stats", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian IT Systems Stats", "tags": [ "estonia", "baltic", "reference", "civic", "computed", "riha", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/riha/stats", "x-examples": {} } }, "/api/v1/podcasts/search": { "get": { "description": "Search for podcasts by keyword across the iTunes podcast directory, one of the largest podcast catalogs in the world. Returns podcast titles, author names, artwork URLs, genre categories, episode counts, and RSS feed URLs. Useful for building podcast discovery features, recommendation engines, and podcast player apps that need to find and display shows.", "operationId": "entertainment_podcasts_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Podcast Search", "tags": [ "entertainment", "global", "search", "itunes", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/podcasts/search?q=technology\"", "x-examples": { "Search for comedy podcasts": "curl \"https://nordapi.ee/api/v1/podcasts/search?q=comedy\"", "Search for technology podcasts": "curl \"https://nordapi.ee/api/v1/podcasts/search?q=technology\"", "Search for true crime podcasts": "curl \"https://nordapi.ee/api/v1/podcasts/search?q=true+crime\"" } } }, "/api/v1/airquality/history/{city}": { "get": { "description": "Hourly air quality snapshots for a supported city, recorded by our own workers every hour. Returns PM10, PM2.5, carbon monoxide, nitrogen dioxide, sulphur dioxide, ozone, US AQI, and European AQI. Filter with ?start and ?end. Useful for long-term pollution studies, comparing cities, evaluating trends for regulatory reporting, and powering dashboards without rate limits on upstream providers.", "operationId": "geo_airquality_city_history", "parameters": [ { "description": "City name (see /weather/cities)", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } }, { "description": "Start datetime", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "City Air Quality History", "tags": [ "geo", "global", "weather", "environment", "snapshot-history", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/airquality/history/beijing?limit=48\"", "x-examples": { "Last 48 hours for Beijing": "curl \"https://nordapi.ee/api/v1/airquality/history/beijing?limit=48\"", "Oslo air quality for a specific week": "curl \"https://nordapi.ee/api/v1/airquality/history/oslo?start=2026-04-08&end=2026-04-15\"" } } }, "/api/v1/weather/history/{city}": { "get": { "description": "Hourly weather snapshots for a supported city, stored continuously by our own workers from the top of every hour. Returns temperature, apparent temperature, humidity, precipitation, wind speed/direction, weather code, and cloud cover. Filter with ?start and ?end (ISO 8601 or YYYY-MM-DD). Useful for building long-running climate dashboards, comparing conditions across cities over time, and analyzing hourly weather patterns without hitting upstream archive APIs.", "operationId": "geo_weather_city_history", "parameters": [ { "description": "City name (see /weather/cities)", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } }, { "description": "Start datetime (ISO 8601 or YYYY-MM-DD)", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime (ISO 8601 or YYYY-MM-DD)", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "City Weather History", "tags": [ "geo", "global", "weather", "snapshot-history", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/weather/history/tallinn?limit=24\"", "x-examples": { "Full stored history for Tokyo": "curl \"https://nordapi.ee/api/v1/weather/history/tokyo?limit=10000\"", "Last 24 hours for Tallinn": "curl \"https://nordapi.ee/api/v1/weather/history/tallinn?limit=24\"", "Oslo weather for a date range": "curl \"https://nordapi.ee/api/v1/weather/history/oslo?start=2026-04-01&end=2026-04-15\"" } } }, "/api/v1/geo/ip": { "get": { "description": "Automatically geolocate the requesting client's IP address. Returns the detected IP, approximate latitude/longitude, city, region, country, timezone, and ISP information. No parameters needed - it uses the caller's IP. Useful for personalizing content by location, auto-selecting language/currency, fraud detection, and analytics dashboards that need to map user locations.", "operationId": "geo_geo_ip", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "IP Geolocation (Auto)", "tags": [ "geo", "global", "geography", "lookup", "ip-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/geo/ip", "x-examples": {} } }, "/api/v1/mashup/location": { "get": { "description": "Comprehensive location profile: combines weather, air quality, elevation, light pollution, nearby earthquakes, and timezone into a single location report.", "operationId": "mashups_location_intel", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Location Intelligence", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/location?lat=59.4&lon=24.7\"", "x-examples": {} } }, "/api/v1/carbonintensity/generation": { "get": { "description": "Get the current UK electricity generation mix showing the percentage contribution from each energy source: wind, solar, nuclear, gas, coal, hydro, biomass, imports, and others. Provides a real-time snapshot of how the UK's electricity is being produced right now. Useful for energy dashboards, climate education tools, and apps that help users understand when renewable energy percentage is highest.", "operationId": "science_carbonintensity_generation", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "UK Generation Mix", "tags": [ "science", "united-kingdom", "europe", "power", "environment", "realtime", "carbonintensity-org-uk", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/carbonintensity/generation", "x-examples": {} } }, "/api/v1/peatus/departures/{stop_id}": { "get": { "description": "Get next departures from any Estonian public transport stop. Returns scheduled and real-time arrival/departure times, route info, headsign, and transport mode. Use the stops endpoint to find GTFS IDs.", "operationId": "estonia_peatus_departures", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Transport Departures", "tags": [ "estonia", "baltic", "transport", "realtime", "peatus-ee", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/peatus/departures/estonia:4341", "x-examples": {} } }, "/api/v1/mashup/estonian/heritage": { "get": { "description": "Plan a cultural heritage trip through Estonia: combines 12,569 monuments, 70 museums, current weather conditions, and daylight hours into a tourism-ready itinerary.", "operationId": "mashups_estonian_heritage", "parameters": [ { "description": "Filter by Estonian county name", "in": "query", "name": "region", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Heritage Trip Planner", "tags": [ "mashups" ], "x-example": "curl https://nordapi.ee/api/v1/mashup/estonian/heritage", "x-examples": {} } }, "/api/v1/dnd/monsters/{name}": { "get": { "description": "Get complete stat block for a specific D&D 5e monster by name or index key. Returns challenge rating, hit points, armor class, ability scores (STR/DEX/CON/INT/WIS/CHA), speed, damage resistances, special abilities, actions, and legendary actions. Data from the official 5e SRD via the D&D 5e API. Essential for encounter balancing tools, virtual tabletop integrations, and DM reference apps used during game sessions.", "operationId": "entertainment_dnd_monster", "parameters": [ { "description": "Monster name or index (e.g., adult-red-dragon, owlbear)", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "D&D Monster Detail", "tags": [ "entertainment", "global", "games", "lookup", "dnd5e-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/dnd/monsters/owlbear", "x-examples": { "Adult Red Dragon stats": "curl https://nordapi.ee/api/v1/dnd/monsters/adult-red-dragon", "Owlbear stats": "curl https://nordapi.ee/api/v1/dnd/monsters/owlbear", "Troll stats": "curl https://nordapi.ee/api/v1/dnd/monsters/troll" } } }, "/api/v1/crypto/ohlc/{coin_id}": { "get": { "description": "Get Open/High/Low/Close price data for a cryptocurrency on a specific date. Computed from the 10-minute snapshots stored throughout the day. Perfect for candlestick charts and daily price summaries.", "operationId": "finance_crypto_ohlc", "parameters": [ { "description": "Date (YYYY-MM-DD)", "in": "path", "name": "date", "required": true, "schema": { "default": "today", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Crypto OHLC", "tags": [ "finance", "global", "crypto", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/crypto/ohlc/bitcoin?date=2026-03-28\"", "x-examples": {} } }, "/api/v1/mashup/poetry/workshop": { "get": { "description": "Creative writing toolkit for any theme: finds classic poems containing your theme, plus related synonyms, rhyming words, and descriptive adjectives from the Datamuse word engine. Returns a curated word palette for writing inspiration.", "operationId": "mashups_poetry_workshop", "parameters": [ { "description": "Theme word (e.g. love, ocean, night, freedom)", "in": "query", "name": "theme", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Poetry Workshop", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/poetry/workshop?theme=love\"", "x-examples": {} } }, "/api/v1/mashup/culinary/route": { "get": { "description": "Food trail planner: combines local recipes, craft breweries, current weather, and upcoming food-related events for any city worldwide.", "operationId": "mashups_culinary_route", "parameters": [ { "description": "City name", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Culinary Tourism Route", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/culinary/route?city=Tallinn\"", "x-examples": {} } }, "/api/v1/lyrics/{artist}/{title}": { "get": { "description": "Retrieve the full lyrics for any song by providing the artist name and song title in the URL path. Returns the complete song text. Data from the lyrics.ovh API covering a vast catalog of songs across all genres and decades. Useful for karaoke apps, music education platforms, lyric analysis tools, songwriting reference, and music trivia features.", "operationId": "entertainment_lyrics", "parameters": [ { "description": "Artist or band name", "in": "query", "name": "artist", "required": true, "schema": { "type": "string" } }, { "description": "Song title", "in": "query", "name": "title", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Song Lyrics", "tags": [ "entertainment", "global", "music", "lookup", "lyrics-ovh", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/lyrics/coldplay/yellow", "x-examples": { "Beatles - Yesterday": "curl https://nordapi.ee/api/v1/lyrics/beatles/yesterday", "Coldplay - Yellow": "curl https://nordapi.ee/api/v1/lyrics/coldplay/yellow", "Queen - Bohemian Rhapsody": "curl https://nordapi.ee/api/v1/lyrics/queen/bohemian+rhapsody" } } }, "/api/v1/elections/ee/{election}/metadata": { "get": { "description": "Election metadata: name, municipalities, counties, and election structure.", "operationId": "estonia_elections_metadata", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Election Metadata", "tags": [ "estonia", "baltic", "elections", "civic", "lookup", "valimised", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/elections/ee/KOV_2025/metadata", "x-examples": {} } }, "/api/v1/estonian-nav-marks/lighthouses": { "get": { "description": "All Estonian lighthouses (Tuletorn) with GPS, light characteristics, sectors, and visibility ranges.", "operationId": "estonia_ee_nav_marks_lighthouses", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Lighthouses", "tags": [ "estonia", "baltic", "transport", "heritage", "lookup", "nma-vta", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-nav-marks/lighthouses", "x-examples": {} } }, "/api/v1/estonian-museums/search": { "get": { "description": "Search museums by name or location.", "operationId": "estonia_ee_museums_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Museums", "tags": [ "estonia", "baltic", "heritage", "search", "muis", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-museums/search?q=tallinn\"", "x-examples": {} } }, "/api/v1/crypto/{coin_id}": { "get": { "description": "Get comprehensive details for a specific cryptocurrency by its CoinGecko ID or ticker symbol (e.g., 'bitcoin' or 'BTC'). Returns the coin's current price, market cap, trading volume, price changes, and metadata. Useful for building dedicated coin detail pages, comparing specific tokens, or fetching data for a user's favorite coins without downloading the entire top-250 list.", "operationId": "finance_crypto_show", "parameters": [ { "description": "CoinGecko ID or symbol (e.g. bitcoin, BTC)", "in": "path", "name": "coin_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Crypto Coin Detail", "tags": [ "finance", "global", "crypto", "lookup", "coingecko", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/crypto/bitcoin", "x-examples": { "Bitcoin detail": "curl https://nordapi.ee/api/v1/crypto/bitcoin", "Ethereum detail": "curl https://nordapi.ee/api/v1/crypto/ethereum", "Solana detail by ticker": "curl https://nordapi.ee/api/v1/crypto/SOL" } } }, "/api/v1/estonian-trademarks/{id}": { "get": { "description": "Get details of a specific trademark by its database ID.", "operationId": "estonia_ee_trademarks_show", "parameters": [ { "description": "Trademark database ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Trademark Details", "tags": [ "estonia", "baltic", "business", "legal", "lookup", "epa-andmebaas", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-trademarks/1", "x-examples": {} } }, "/api/v1/estonian-health/covid/infections": { "get": { "description": "COVID-19 infection data by county, age group, and gender for Estonia.", "operationId": "estonia_ee_covid_infections", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } }, { "description": "Offset", "in": "query", "name": "offset", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian COVID Infections", "tags": [ "estonia", "baltic", "health", "lookup", "tehik", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-health/covid/infections?limit=10\"", "x-examples": {} } }, "/api/v1/vat": { "get": { "description": "Get current Value Added Tax (VAT) rates for all 32 EU and EEA countries, including standard rates, reduced rates, and super-reduced rates where applicable. Essential for e-commerce platforms selling to European customers, tax compliance tools, invoice generators, and any business that needs to apply the correct VAT rate based on the buyer's country.", "operationId": "finance_vat", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "All VAT Rates", "tags": [ "finance", "global", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/vat", "x-examples": {} } }, "/api/v1/emoji/random": { "get": { "description": "Get a random emoji with its Unicode code point, HTML entity, character, name, category, and group. Covers the full Unicode emoji catalog including smileys, animals, food, activities, objects, symbols, and flags. Useful for chatbot personality features, social media tools, creative writing prompts, fun UI elements, and any app that wants to add a touch of playful randomness.", "operationId": "food_emoji_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Emoji", "tags": [ "food", "global", "reference", "generators", "lookup", "emojihub", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/emoji/random", "x-examples": {} } }, "/api/v1/shopping/categories": { "get": { "description": "Get all available shopping event categories (e.g., general sales, tech deals, fashion events, holiday shopping). Use this to understand how shopping events are classified and to build filtered views of shopping events by category in your application.", "operationId": "world_shopping_categories", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Shopping Categories", "tags": [ "world", "global", "business", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/shopping/categories", "x-examples": {} } }, "/api/v1/tallinn/data/query": { "get": { "description": "Query any Tallinn open data table by name. Supports SQL-like filters, column selection, ordering, and pagination. Use the tables endpoint to discover available datasets.", "operationId": "estonia_tallinn_data_query", "parameters": [ { "description": "Table name (e.g. rahvastik, eelarve, teede_sulgemised)", "in": "query", "name": "table", "required": true, "schema": { "type": "string" } }, { "description": "Results per page (max 1000)", "in": "query", "name": "per_page", "required": false, "schema": { "default": "100", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "1", "type": "string" } }, { "description": "Columns to select", "in": "query", "name": "columns", "required": false, "schema": { "default": "*", "type": "string" } }, { "description": "SQL WHERE clause filter", "in": "query", "name": "filters", "required": false, "schema": { "type": "string" } }, { "description": "Column(s) to order by", "in": "query", "name": "order_by", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Query Tallinn Open Data", "tags": [ "estonia", "baltic", "civic", "search", "avaandmed-tallinn", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/tallinn/data/query?table=rahvastik&per_page=10\"", "x-examples": {} } }, "/api/v1/harrypotter/characters": { "get": { "description": "Get all characters from the Harry Potter universe, including name, house, ancestry, patronus, actor, wand details, and whether they are a wizard or student. Data from the HP-API covering characters from all seven books and eight films. Useful for Harry Potter fan apps, character encyclopedias, trivia games, and Wizarding World companion tools.", "operationId": "entertainment_harrypotter_characters", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Harry Potter Characters", "tags": [ "entertainment", "global", "movies", "lookup", "hp-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/harrypotter/characters", "x-examples": { "Browse the character database": "curl https://nordapi.ee/api/v1/harrypotter/characters", "List all Harry Potter characters": "curl https://nordapi.ee/api/v1/harrypotter/characters" } } }, "/api/v1/history/range": { "get": { "description": "Retrieve exchange rates for every day within a historical date range from the ECB archive (back to 1999). Returns daily rates for the specified base and target currencies across the entire range. Perfect for building long-term exchange rate charts, academic datasets, economic history visualizations, and backtesting financial models across months or years of data.", "operationId": "finance_history_range", "parameters": [ { "description": "Start date", "in": "query", "name": "start", "required": true, "schema": { "type": "string" } }, { "description": "End date", "in": "query", "name": "end", "required": true, "schema": { "type": "string" } }, { "description": "Base currency", "in": "query", "name": "base", "required": false, "schema": { "type": "string" } }, { "description": "Target currencies", "in": "query", "name": "symbols", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Historical Archive (Range)", "tags": [ "finance", "global", "snapshot-history", "ecb", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/history/range?start=2020-01-01&end=2020-06-30&base=USD&symbols=EUR\"", "x-examples": { "GBP rates around Brexit vote": "curl \"https://nordapi.ee/api/v1/history/range?start=2016-06-01&end=2016-07-31&base=GBP&symbols=EUR,USD\"", "NOK rates during COVID crash period": "curl \"https://nordapi.ee/api/v1/history/range?start=2020-03-01&end=2020-04-30&base=NOK&symbols=EUR,USD\"", "USD/EUR during first half of 2020": "curl \"https://nordapi.ee/api/v1/history/range?start=2020-01-01&end=2020-06-30&base=USD&symbols=EUR\"" } } }, "/api/v1/estonian-nav-marks": { "get": { "description": "1,654 lighthouses, buoys, beacons and leading lines in Estonian waters. Includes GPS coordinates, light characteristics, sectors, visibility, heights, and maintenance info. From Transpordiamet NMA open data (nma.vta.ee), updated daily.", "operationId": "estonia_ee_nav_marks", "parameters": [ { "description": "Filter by type (e.g. Tuletorn, Poi)", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } }, { "description": "Filter by service region", "in": "query", "name": "region", "required": false, "schema": { "type": "string" } }, { "description": "Set to 'true' for lit marks only", "in": "query", "name": "light", "required": false, "schema": { "type": "string" } }, { "description": "Results per page (max 500)", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Navigational Marks", "tags": [ "estonia", "baltic", "transport", "heritage", "lookup", "nma-vta", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-nav-marks", "x-examples": {} } }, "/api/v1/estonian-border/history": { "get": { "description": "Time series of Estonia-Russia border queue lengths at Narva, Koidula, and Luhamaa, recorded every 15 minutes. Nobody else archives this publicly. Filter by ?crossing (narva/koidula/luhamaa) and ?start/?end. Useful for journalists, logistics firms tracking freight delays, travelers planning trips, and researchers studying the effects of geopolitical events on cross-border traffic.", "operationId": "estonia_border_history", "parameters": [ { "description": "narva, koidula, or luhamaa", "in": "path", "name": "crossing", "required": true, "schema": { "type": "string" } }, { "description": "Start datetime", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonia-Russia Border Queue History", "tags": [ "estonia", "baltic", "transport", "travel", "snapshot-history", "eestipiir", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-border/history?crossing=narva&limit=96\"", "x-examples": { "All crossings for a specific day": "curl \"https://nordapi.ee/api/v1/estonian-border/history?start=2026-04-14&end=2026-04-15\"", "Last 24 hours at Narva": "curl \"https://nordapi.ee/api/v1/estonian-border/history?crossing=narva&limit=96\"" } } }, "/api/v1/dnd/classes": { "get": { "description": "Browse all playable character classes from the D&D 5th Edition System Reference Document. Returns class names and index keys for the 12 core classes: Barbarian, Bard, Cleric, Druid, Fighter, Monk, Paladin, Ranger, Rogue, Sorcerer, Warlock, and Wizard. Data from the open D&D 5e API. Useful for character creation tools, class comparison features, and RPG companion apps.", "operationId": "entertainment_dnd_classes", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "D&D Class List", "tags": [ "entertainment", "global", "games", "lookup", "dnd5e-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/dnd/classes", "x-examples": { "Browse playable classes": "curl https://nordapi.ee/api/v1/dnd/classes", "List all D&D classes": "curl https://nordapi.ee/api/v1/dnd/classes" } } }, "/api/v1/volatility": { "get": { "description": "Measure the volatility of a currency pair by calculating the standard deviation of daily rate changes over a configurable period (default 30 days). Returns the volatility score and mean daily change percentage. Essential for risk assessment in international trade, hedging decisions, setting appropriate margins on currency conversion services, and understanding how stable or turbulent a currency pair has been recently.", "operationId": "finance_volatility", "parameters": [ { "description": "Base currency", "in": "query", "name": "base", "required": true, "schema": { "type": "string" } }, { "description": "Target currency", "in": "query", "name": "target", "required": true, "schema": { "type": "string" } }, { "description": "Days", "in": "query", "name": "period", "required": false, "schema": { "default": "30", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Volatility", "tags": [ "finance", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/volatility?base=EUR&target=USD\"", "x-examples": { "EUR/USD 30-day volatility (default)": "curl \"https://nordapi.ee/api/v1/volatility?base=EUR&target=USD\"", "GBP/NOK 14-day volatility": "curl \"https://nordapi.ee/api/v1/volatility?base=GBP&target=NOK&period=14\"", "USD/JPY 60-day volatility": "curl \"https://nordapi.ee/api/v1/volatility?base=USD&target=JPY&period=60\"" } } }, "/api/v1/estonian-monuments": { "get": { "description": "Browse 12,569 Estonian cultural monuments from the National Heritage Board. Filter by county, type, or protection level. Data sourced from Maa-amet GeoServer WFS.", "operationId": "estonia_ee_monuments", "parameters": [ { "description": "Filter by county", "in": "query", "name": "county", "required": false, "schema": { "type": "string" } }, { "description": "Filter by monument type", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } }, { "description": "Results per page (default 100)", "in": "path", "name": "limit", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cultural Monuments", "tags": [ "estonia", "baltic", "heritage", "lookup", "register-muinas", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-monuments", "x-examples": {} } }, "/api/v1/mashup/travel/safety": { "get": { "description": "Generate a comprehensive travel safety report for any destination country, combining health indicators, earthquake risk, weather conditions, political stability data, and holiday information. Compares the destination safety profile against your home country. Returns an overall safety score with category breakdowns for health, natural disaster risk, and security. Perfect for travel insurance apps, corporate travel management tools, and trip planning platforms that need to inform travelers about destination risks.", "operationId": "mashups_travel_safety", "parameters": [ { "description": "Destination country code", "in": "query", "name": "destination", "required": true, "schema": { "type": "string" } }, { "description": "Home country code for comparison", "in": "query", "name": "home", "required": false, "schema": { "default": "US", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Travel Safety Report", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/travel/safety?destination=JP\"", "x-examples": { "Safety report for Brazil": "curl \"https://nordapi.ee/api/v1/mashup/travel/safety?destination=BR\"", "Safety report for Japan": "curl \"https://nordapi.ee/api/v1/mashup/travel/safety?destination=JP\"", "Safety report for Thailand from Norway": "curl \"https://nordapi.ee/api/v1/mashup/travel/safety?destination=TH&home=NO\"" } } }, "/api/v1/estonian-environment/classifiers/{type}": { "get": { "description": "Lookup tables for environmental monitoring classifications — indicator types, measurement methods, sampling methods, and other reference data used in the KESE system.", "operationId": "estonia_ee_env_classifiers", "parameters": [ { "description": "Classifier type", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Environmental Classifiers", "tags": [ "estonia", "baltic", "environment", "lookup", "kese-envir", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-environment/classifiers/INDICATOR_TYPE", "x-examples": {} } }, "/api/v1/github/user/{username}/repos": { "get": { "description": "Get a list of public repositories for a specific GitHub user, including repo names, descriptions, star counts, fork counts, primary language, and last update dates. Useful for building developer portfolio pages, analyzing a user's open source contributions, and creating project showcases. Data from the GitHub REST API.", "operationId": "news_github_repos", "parameters": [ { "description": "Username", "in": "query", "name": "username", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "User Repos", "tags": [ "news", "global", "social", "lookup", "github", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/github/user/torvalds/repos", "x-examples": { "Jose Valim repositories": "curl https://nordapi.ee/api/v1/github/user/josevalim/repos", "Linus Torvalds repositories": "curl https://nordapi.ee/api/v1/github/user/torvalds/repos" } } }, "/api/v1/tallinn/practical": { "get": { "description": "Practical visitor and resident info: 30 free WiFi hotspots, ferry routes to Helsinki/Stockholm with schedules, 157 EV charging stations, and the Tallinn Card tourist pass with prices.", "operationId": "estonia_tallinn_practical", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Practical Info", "tags": [ "estonia", "baltic", "civic", "travel", "lookup", "tallinn-life", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/practical", "x-examples": {} } }, "/api/v1/estonian-medical-devices/incidents": { "get": { "description": "All reported medical device incidents in Estonia from the Health Board (Terviseamet). Includes device name, manufacturer, incident date, and description.", "operationId": "estonia_ee_medical_incidents", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Medical Device Incidents", "tags": [ "estonia", "baltic", "health", "civic", "lookup", "msa-sm", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-medical-devices/incidents", "x-examples": {} } }, "/api/v1/pagespeed/analyze": { "get": { "description": "Analyze any website's performance using the Google PageSpeed Insights API. Returns a 0-100 performance score, Core Web Vitals metrics (LCP, FID, CLS), specific improvement suggestions, and resource load breakdowns. Supports mobile and desktop analysis strategies. Useful for web performance monitoring dashboards, SEO tools, client reporting, and development workflows that track site speed over time.", "operationId": "tools_pagespeed", "parameters": [ { "description": "URL", "in": "query", "name": "url", "required": true, "schema": { "type": "string" } }, { "description": "mobile or desktop", "in": "query", "name": "strategy", "required": false, "schema": { "default": "mobile", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "PageSpeed Analysis", "tags": [ "tools", "global", "lookup", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/pagespeed/analyze?url=https://nordapi.ee\"", "x-examples": { "Analyze GitHub on mobile": "curl \"https://nordapi.ee/api/v1/pagespeed/analyze?url=https://github.com&strategy=mobile\"", "Analyze Google on desktop": "curl \"https://nordapi.ee/api/v1/pagespeed/analyze?url=https://google.com&strategy=desktop\"", "Analyze NordAPI on mobile": "curl \"https://nordapi.ee/api/v1/pagespeed/analyze?url=https://nordapi.ee\"" } } }, "/api/v1/estonian-mtr/license-categories": { "get": { "description": "List all license category types.", "operationId": "estonia_ee_mtr_license_categories", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "License Categories", "tags": [ "estonia", "baltic", "business", "legal", "lookup", "mtr-ttja", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-mtr/license-categories", "x-examples": {} } }, "/api/v1/tarot/random": { "get": { "description": "Draw a random tarot card from the full 78-card deck (22 Major Arcana and 56 Minor Arcana). Returns the card name, arcana type, suit (for Minor Arcana), number, upright and reversed meanings, and description. Each draw is random and independent. Useful for daily tarot reading apps, divination tools, fortune-telling entertainment features, and mysticism-themed games or creative writing prompts.", "operationId": "entertainment_tarot_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Tarot Card", "tags": [ "entertainment", "global", "games", "computed", "tarotapi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tarot/random", "x-examples": { "Draw a random tarot card": "curl https://nordapi.ee/api/v1/tarot/random", "Draw another card": "curl https://nordapi.ee/api/v1/tarot/random", "Get your daily tarot reading": "curl https://nordapi.ee/api/v1/tarot/random" } } }, "/api/v1/mashup/estonian/power": { "get": { "description": "Combined power grid intelligence: real-time Elektrilevi outages with current electricity price, weather station wind speeds, and storm warnings. Correlates high winds with outage risk.", "operationId": "mashups_estonian_power", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Power Grid Status", "tags": [ "mashups" ], "x-example": "curl https://nordapi.ee/api/v1/mashup/estonian/power", "x-examples": {} } }, "/api/v1/shopping/country/{code}": { "get": { "description": "Get all shopping events and sale holidays specific to a particular country, including both global events (Black Friday) and country-specific ones (e.g., Boxing Day in the UK, Singles Day in China). Useful for localizing e-commerce promotions and understanding the retail calendar in specific markets.", "operationId": "world_shopping_country", "parameters": [ { "description": "Country", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Shopping by Country", "tags": [ "world", "global", "business", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/shopping/country/US", "x-examples": { "China shopping events": "curl https://nordapi.ee/api/v1/shopping/country/CN", "UK shopping events": "curl https://nordapi.ee/api/v1/shopping/country/GB", "US shopping events": "curl https://nordapi.ee/api/v1/shopping/country/US" } } }, "/api/v1/riigiteataja/laws": { "get": { "description": "Browse and search major Estonian laws from Riigi Teataja (State Gazette). Includes the Constitution, tax laws, commercial code, employment law, data protection, and more. Filter by title or category.", "operationId": "estonia_riigiteataja_laws", "parameters": [ { "description": "Search query (filters by title or category)", "in": "query", "name": "q", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Legislation", "tags": [ "estonia", "baltic", "legal", "search", "riigi-teataja", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/riigiteataja/laws", "x-examples": {} } }, "/api/v1/music/itunes": { "get": { "description": "Search the Apple iTunes catalog for music, podcasts, movies, TV shows, audiobooks, and other media. Returns titles, artist names, artwork URLs, preview links, and pricing. Supports filtering by media type. Useful for building media search features, comparing content across platforms, and creating rich media discovery experiences. Data from the iTunes Search API.", "operationId": "entertainment_music_itunes", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } }, { "description": "Media type", "in": "query", "name": "media", "required": false, "schema": { "default": "music", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "iTunes Search", "tags": [ "entertainment", "global", "music", "search", "itunes", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/music/itunes?q=Radiohead\"", "x-examples": { "Search for audiobooks": "curl \"https://nordapi.ee/api/v1/music/itunes?q=harry+potter&media=audiobook\"", "Search for podcasts about technology": "curl \"https://nordapi.ee/api/v1/music/itunes?q=technology&media=podcast\"", "Search iTunes for Radiohead music": "curl \"https://nordapi.ee/api/v1/music/itunes?q=Radiohead\"" } } }, "/api/v1/estonian-cemeteries/{region}": { "get": { "description": "List cemeteries in a specific county or city (e.g. Tallinn, Harju, Tartu). Returns names and kalmistud.ee URLs.", "operationId": "estonia_ee_cemeteries_region", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cemeteries by Region", "tags": [ "estonia", "baltic", "heritage", "lookup", "kalmistud", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-cemeteries/Tallinn", "x-examples": {} } }, "/api/v1/colors/{hex}": { "get": { "description": "Get comprehensive information about any color by its hex code. Returns the closest named color, RGB, HSL, HSV, and CMYK values, contrast suggestions, and a preview image URL. Useful for design tools, accessibility checkers that need color contrast data, color conversion utilities, and educational apps teaching color theory.", "operationId": "tools_colors_lookup", "parameters": [ { "description": "Hex color", "in": "query", "name": "hex", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Color Info", "tags": [ "tools", "global", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/colors/4287f5", "x-examples": { "Info about a blue color": "curl https://nordapi.ee/api/v1/colors/4287f5", "Info about a dark green": "curl https://nordapi.ee/api/v1/colors/2ecc71", "Info about pure red": "curl https://nordapi.ee/api/v1/colors/ff0000" } } }, "/api/v1/museum/chicago/{id}": { "get": { "description": "Get detailed information about a specific artwork at the Art Institute of Chicago, including description, style, classification, and place of origin.", "operationId": "art_chicago_artwork", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Get Chicago Artwork", "tags": [ "art", "global", "heritage", "lookup", "artic", "cc-by", "none" ], "x-example": "curl https://nordapi.ee/api/v1/museum/chicago/111628", "x-examples": {} } }, "/api/v1/tides/predictions/{station}": { "get": { "description": "Get predicted high and low tide times and heights for a specific NOAA tide station. Returns upcoming tide events with timestamps and water levels. Essential for coastal activity planning, marine navigation, fishing apps, and beach-going schedulers. Provide a valid NOAA station ID (use the stations endpoint to find IDs).", "operationId": "geo_tides_predictions", "parameters": [ { "description": "NOAA station ID", "in": "path", "name": "station", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tide Predictions", "tags": [ "geo", "united-states", "americas", "weather", "realtime", "noaa", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tides/predictions/9414290", "x-examples": { "Tide predictions for Miami": "curl https://nordapi.ee/api/v1/tides/predictions/8723214", "Tide predictions for New York (The Battery)": "curl https://nordapi.ee/api/v1/tides/predictions/8518750", "Tide predictions for San Francisco": "curl https://nordapi.ee/api/v1/tides/predictions/9414290" } } }, "/api/v1/poetry/title/{title}": { "get": { "description": "Search for poems by title. Returns matching poems with full text.", "operationId": "language_poetry_title", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Poem by Title", "tags": [ "language", "global", "poetry", "search", "poetrydb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/poetry/title/Ozymandias", "x-examples": {} } }, "/api/v1/metals/prices": { "get": { "description": "Get current spot prices for gold, silver, platinum, and palladium in any of the 30 supported currencies. Returns per-troy-ounce prices for each metal. Ideal for investment tracking apps, jewelry pricing calculators, and financial dashboards that need precious metals alongside currency data. Prices are updated daily and can be displayed in local currencies like NOK or SEK for Nordic users.", "operationId": "finance_metals_prices", "parameters": [ { "description": "Price currency", "in": "query", "name": "base", "required": false, "schema": { "default": "USD", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Precious Metals Prices", "tags": [ "finance", "global", "commodities", "realtime", "frankfurter", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/metals/prices", "x-examples": { "All metals in GBP": "curl \"https://nordapi.ee/api/v1/metals/prices?base=GBP\"", "All metals in NOK": "curl \"https://nordapi.ee/api/v1/metals/prices?base=NOK\"", "All metals in USD (default)": "curl \"https://nordapi.ee/api/v1/metals/prices\"" } } }, "/api/v1/historical/{date}": { "get": { "description": "Retrieve exchange rates for any specific past date. Provide a date in YYYY-MM-DD format in the URL path, and optionally filter by base currency and target symbols. Useful for generating historical invoices, auditing past transactions, back-testing trading strategies, and building exchange rate charts. Data sourced from ECB daily reference rates.", "operationId": "finance_historical", "parameters": [ { "description": "Date in URL (YYYY-MM-DD)", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } }, { "description": "Base currency", "in": "query", "name": "base", "required": false, "schema": { "default": "EUR", "type": "string" } }, { "description": "Target currencies", "in": "query", "name": "symbols", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Historical Rates", "tags": [ "finance", "global", "snapshot-history", "frankfurter", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/historical/2026-03-15?base=USD\"", "x-examples": { "EUR rates for specific currencies on a date": "curl \"https://nordapi.ee/api/v1/historical/2026-01-01?base=EUR&symbols=NOK,SEK,DKK\"", "Historical rates on New Year's Day 2025": "curl \"https://nordapi.ee/api/v1/historical/2025-01-02?base=GBP&symbols=USD,EUR\"", "Rates on a specific date with USD base": "curl \"https://nordapi.ee/api/v1/historical/2026-03-15?base=USD\"" } } }, "/api/v1/memes/templates": { "get": { "description": "Get a list of popular meme templates with their IDs, names, and blank template image URLs. Covers classic internet memes like Drake Hotline Bling, Distracted Boyfriend, Change My Mind, and many more. Use template IDs for search or to build meme generators. Data from Imgflip. Useful for meme generator apps, social media tools, chat integrations, and entertainment platforms that let users create or browse memes.", "operationId": "entertainment_memes_templates", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Meme Templates", "tags": [ "entertainment", "global", "lookup", "imgflip", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/memes/templates", "x-examples": { "Browse popular meme templates": "curl https://nordapi.ee/api/v1/memes/templates", "Get all available meme templates": "curl https://nordapi.ee/api/v1/memes/templates" } } }, "/api/v1/carbon/country/{code}": { "get": { "description": "Get CO2 emissions per capita and total emissions for a specific country, with historical data over multiple years. Data sourced from the World Bank. Useful for climate research dashboards, environmental education tools, country comparison features, and ESG (Environmental, Social, Governance) reporting applications that need country-level emission profiles.", "operationId": "science_carbon_country", "parameters": [ { "description": "Country code", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Country Emissions", "tags": [ "science", "global", "environment", "statistics", "lookup", "world-bank", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/carbon/country/NO", "x-examples": { "China emissions profile": "curl https://nordapi.ee/api/v1/carbon/country/CN", "Norway emissions profile": "curl https://nordapi.ee/api/v1/carbon/country/NO", "US emissions profile": "curl https://nordapi.ee/api/v1/carbon/country/US" } } }, "/api/v1/generate/user": { "get": { "description": "Generate realistic but entirely fake user profiles for testing and development. Each profile includes a random name, email, username, address, phone number, date of birth, and avatar URL. Useful for populating test databases, UI prototyping with realistic data, demo environments, load testing, and anywhere you need realistic user data without using real personal information.", "operationId": "tools_generate_user", "parameters": [ { "description": "Count", "in": "query", "name": "count", "required": false, "schema": { "default": "1", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Fake User Profile", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/generate/user", "x-examples": { "Generate 20 test users for seeding": "curl \"https://nordapi.ee/api/v1/generate/user?count=20\"", "Generate 5 fake users": "curl \"https://nordapi.ee/api/v1/generate/user?count=5\"", "Generate a single fake user": "curl https://nordapi.ee/api/v1/generate/user" } } }, "/api/v1/tallinn/facts": { "get": { "description": "Key facts about Tallinn: founded 1248, UNESCO Old Town, population, area, coordinates, timezone, e-Residency, free public transport, birthplace of Skype, and more.", "operationId": "estonia_tallinn_facts", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn City Facts", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-info", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/facts", "x-examples": {} } }, "/api/v1/radio/countries": { "get": { "description": "List all countries that have internet radio stations in the Radio Browser database, along with the number of stations available in each country. Useful for building country-based radio browsing interfaces and discovering which countries have the most active internet radio scenes.", "operationId": "entertainment_radio_countries", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Radio Countries", "tags": [ "entertainment", "global", "music", "lookup", "radio-browser", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/radio/countries", "x-examples": {} } }, "/api/v1/pollen/stations": { "get": { "description": "List all 16 automatic pollen monitoring stations across Switzerland operated by MeteoSwiss. Returns station codes, names, cantons, GPS coordinates, and altitudes. These are real sensor stations using digital holography, not modeled estimates. Data is CC-BY licensed from MeteoSwiss open data.", "operationId": "geo_pollen_stations", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Pollen Monitoring Stations", "tags": [ "geo", "switzerland", "europe", "environment", "health", "reference", "lookup", "pollen-meteoswiss", "cc-by", "none" ], "x-example": "curl https://nordapi.ee/api/v1/pollen/stations", "x-examples": {} } }, "/api/v1/earthquakes/significant": { "get": { "description": "Get only the most significant recent earthquakes (magnitude 6.0 and above) from USGS. These are the events that can cause major damage and are felt across wide areas. Returns location, magnitude, depth, and time. Useful for disaster response dashboards, news apps covering natural disasters, and global risk assessment tools that focus on high-impact seismic events.", "operationId": "science_earthquakes_significant", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Significant Earthquakes", "tags": [ "science", "global", "earthquakes", "realtime", "earthquakes-usgs", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/earthquakes/significant", "x-examples": {} } }, "/api/v1/carbonintensity/date/{date}": { "get": { "description": "Get half-hourly carbon intensity data for the UK electricity grid on a specific historical date. Returns 48 half-hour readings showing how carbon intensity varied throughout the day. Useful for analyzing historical patterns, comparing weekday vs weekend energy profiles, and building time-series visualizations of UK grid cleanliness over time. Data from the National Grid ESO.", "operationId": "science_carbonintensity_date", "parameters": [ { "description": "Date", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "UK Carbon by Date", "tags": [ "science", "united-kingdom", "europe", "power", "environment", "lookup", "carbonintensity-org-uk", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/carbonintensity/date/2026-03-20", "x-examples": { "Carbon intensity on Christmas Day": "curl https://nordapi.ee/api/v1/carbonintensity/date/2025-12-25", "Carbon intensity on a specific date": "curl https://nordapi.ee/api/v1/carbonintensity/date/2026-03-20" } } }, "/api/v1/podcasts/top": { "get": { "description": "Get the current top/trending podcasts by country from the iTunes podcast charts. Returns podcast titles, authors, artwork, genres, and rankings. Filter by country code (default US) to see local charts. Useful for featured podcast sections, trending content feeds, and understanding what audiences in different countries are listening to.", "operationId": "entertainment_podcasts_top", "parameters": [ { "description": "Country code", "in": "query", "name": "country", "required": false, "schema": { "default": "us", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Top Podcasts", "tags": [ "entertainment", "global", "realtime", "itunes", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/podcasts/top?country=us\"", "x-examples": { "Top podcasts in Norway": "curl \"https://nordapi.ee/api/v1/podcasts/top?country=no\"", "Top podcasts in the UK": "curl \"https://nordapi.ee/api/v1/podcasts/top?country=gb\"", "Top podcasts in the US": "curl \"https://nordapi.ee/api/v1/podcasts/top?country=us\"" } } }, "/api/v1/shopping/active": { "get": { "description": "Check which shopping events and sales holidays are currently active right now. Returns any ongoing events with their names, start and end dates, and descriptions. Perfect for e-commerce banners that auto-display during sale events, deal aggregator apps, and marketing automation tools that trigger campaigns during active shopping periods.", "operationId": "world_shopping_active", "parameters": [ { "description": "Country", "in": "query", "name": "country", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Active Shopping Events", "tags": [ "world", "global", "business", "reference", "realtime", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/shopping/active", "x-examples": { "Active shopping events in the US": "curl \"https://nordapi.ee/api/v1/shopping/active?country=US\"", "Active shopping events worldwide": "curl https://nordapi.ee/api/v1/shopping/active" } } }, "/api/v1/xkcd/{num}": { "get": { "description": "Get a specific xkcd comic by its number. Returns the comic title, number, image URL, alt text, and publication date. Useful for building comic browsers, linking to specific strips in discussions, creating curated xkcd collections, and educational references to specific science or math-related comics.", "operationId": "entertainment_xkcd_show", "parameters": [ { "description": "Comic number", "in": "query", "name": "num", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Specific xkcd Comic", "tags": [ "entertainment", "global", "lookup", "xkcd", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/xkcd/327", "x-examples": { "Bobby Tables (SQL injection comic #327)": "curl https://nordapi.ee/api/v1/xkcd/327", "Compiling comic #303": "curl https://nordapi.ee/api/v1/xkcd/303", "Standards comic #927": "curl https://nordapi.ee/api/v1/xkcd/927" } } }, "/api/v1/dnd/spells/{name}": { "get": { "description": "Get complete details for a specific D&D 5e spell by name or index key. Returns spell level, school of magic, casting time, range, components (verbal, somatic, material), duration, description, damage dice, saving throw type, and which classes can learn it. Data from the official 5e SRD via the D&D 5e API. Essential for digital character sheets, spell slot trackers, and combat reference tools.", "operationId": "entertainment_dnd_spell", "parameters": [ { "description": "Spell name or index (e.g., fireball, magic-missile)", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "D&D Spell Detail", "tags": [ "entertainment", "global", "games", "lookup", "dnd5e-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/dnd/spells/fireball", "x-examples": { "Fireball spell details": "curl https://nordapi.ee/api/v1/dnd/spells/fireball", "Healing Word spell details": "curl https://nordapi.ee/api/v1/dnd/spells/healing-word", "Magic Missile spell details": "curl https://nordapi.ee/api/v1/dnd/spells/magic-missile" } } }, "/api/v1/names/predict/{name}": { "get": { "description": "Get a complete demographic prediction for any first name, combining age estimation, gender prediction, and likely nationalities into a single response. Uses statistical models trained on millions of records from government databases worldwide. Returns predicted age, gender probability, and top nationality matches. Ideal for marketing personalization, user onboarding flows, demographic research, and name-based analytics tools.", "operationId": "world_names_predict", "parameters": [ { "description": "First name to analyze", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Name Demographics (All)", "tags": [ "world", "global", "reference", "statistics", "lookup", "various", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/names/predict/erik", "x-examples": { "Predict demographics for Erik": "curl https://nordapi.ee/api/v1/names/predict/erik", "Predict demographics for Maria": "curl https://nordapi.ee/api/v1/names/predict/maria", "Predict demographics for Yuki": "curl https://nordapi.ee/api/v1/names/predict/yuki" } } }, "/api/v1/generate/uuid": { "get": { "description": "Generate one or more cryptographically random UUID v4 identifiers. UUIDs are universally unique 128-bit identifiers in the standard 8-4-4-4-12 format (e.g., 550e8400-e29b-41d4-a716-446655440000). Useful for generating database primary keys, session tokens, correlation IDs for distributed systems, and any situation where you need globally unique identifiers without a central registry.", "operationId": "tools_generate_uuid", "parameters": [ { "description": "Count", "in": "query", "name": "count", "required": false, "schema": { "default": "1", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "UUID Generator", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/generate/uuid", "x-examples": { "Generate 10 UUIDs": "curl \"https://nordapi.ee/api/v1/generate/uuid?count=10\"", "Generate 5 UUIDs": "curl \"https://nordapi.ee/api/v1/generate/uuid?count=5\"", "Generate a single UUID": "curl https://nordapi.ee/api/v1/generate/uuid" } } }, "/api/v1/games/free/{id}": { "get": { "description": "Get detailed information about a specific free-to-play game including screenshots, system requirements, and description.", "operationId": "gaming_free_game", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Free Game Details", "tags": [ "gaming", "global", "games", "lookup", "free-to-game", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/games/free/452", "x-examples": {} } }, "/api/v1/nobel/prizes": { "get": { "description": "Browse Nobel Prize data by year and/or category (physics, chemistry, medicine, literature, peace, economics). Returns prize details including laureate names, motivations, and share amounts. Data from the official Nobel Foundation API. Useful for education platforms, history apps, scientific achievement timelines, and trivia features.", "operationId": "world_nobel_prizes", "parameters": [ { "description": "Year", "in": "query", "name": "year", "required": false, "schema": { "type": "string" } }, { "description": "Category", "in": "path", "name": "category", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Nobel Prizes", "tags": [ "world", "global", "reference", "science", "lookup", "nobel", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/nobel/prizes?year=2025\"", "x-examples": { "All 2025 Nobel Prizes": "curl \"https://nordapi.ee/api/v1/nobel/prizes?year=2025\"", "Peace prizes in 2024": "curl \"https://nordapi.ee/api/v1/nobel/prizes?year=2024&category=peace\"", "Physics Nobel Prizes": "curl \"https://nordapi.ee/api/v1/nobel/prizes?category=physics\"" } } }, "/api/v1/carbonintensity/current": { "get": { "description": "Get the current carbon intensity of the UK electricity grid in grams of CO2 per kilowatt-hour (gCO2/kWh), along with the forecast for the next few hours. Lower values mean cleaner electricity. Data from the UK National Grid ESO Carbon Intensity API. Essential for smart home systems that shift energy-intensive tasks to low-carbon periods, EV charging optimizers, and UK energy dashboards.", "operationId": "science_carbonintensity_current", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "UK Grid Carbon (Current)", "tags": [ "science", "united-kingdom", "europe", "power", "environment", "realtime", "carbonintensity-org-uk", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/carbonintensity/current", "x-examples": {} } }, "/api/v1/estonian-cemeteries": { "get": { "description": "All 1,008 Estonian cemeteries across 16 regions, scraped from kalmistud.ee. Returns cemetery counts by region.", "operationId": "estonia_ee_cemeteries", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Cemeteries", "tags": [ "estonia", "baltic", "heritage", "lookup", "kalmistud", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-cemeteries", "x-examples": {} } }, "/api/v1/tarot/all": { "get": { "description": "Get the complete 78-card tarot deck with full details for every card. Includes all 22 Major Arcana cards (The Fool through The World) and all 56 Minor Arcana cards across four suits (Cups, Pentacles, Swords, Wands). Each card includes name, arcana type, suit, number, and upright and reversed meanings. Useful for building tarot reference apps, card browsing interfaces, tarot learning tools, and complete deck displays.", "operationId": "entertainment_tarot_all", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "All Tarot Cards", "tags": [ "entertainment", "global", "games", "lookup", "tarotapi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tarot/all", "x-examples": { "Browse all 78 tarot cards": "curl https://nordapi.ee/api/v1/tarot/all", "Get the complete tarot deck": "curl https://nordapi.ee/api/v1/tarot/all" } } }, "/api/v1/commodities/{commodity}/history": { "get": { "description": "Retrieve historical daily prices for any commodity over a custom date range. Returns an array of date-price pairs in USD. Useful for charting commodity price trends, performing technical analysis on gold or oil, backtesting commodity trading strategies, and building historical comparison tools that show how commodity prices moved during specific economic events.", "operationId": "finance_commodity_history", "parameters": [ { "description": "Commodity name", "in": "query", "name": "commodity", "required": true, "schema": { "type": "string" } }, { "description": "Start date", "in": "query", "name": "start_date", "required": true, "schema": { "type": "string" } }, { "description": "End date", "in": "query", "name": "end_date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Commodity History", "tags": [ "finance", "global", "commodities", "snapshot-history", "frankfurter", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/commodities/gold/history?start_date=2026-03-01&end_date=2026-03-24\"", "x-examples": { "Gold price history for March 2026": "curl \"https://nordapi.ee/api/v1/commodities/gold/history?start_date=2026-03-01&end_date=2026-03-24\"", "Oil price history over a quarter": "curl \"https://nordapi.ee/api/v1/commodities/oil/history?start_date=2026-01-01&end_date=2026-03-24\"", "Silver price history for February": "curl \"https://nordapi.ee/api/v1/commodities/silver/history?start_date=2026-02-01&end_date=2026-02-28\"" } } }, "/api/v1/vat/{country_code}": { "get": { "description": "Get the VAT rate details for a specific EU/EEA country by its ISO country code. Returns the standard rate, reduced rate, and the country's local currency. Ideal for checkout flows where you know the customer's country and need to calculate the correct tax, or for displaying country-specific pricing information on product pages.", "operationId": "finance_vat_rate", "parameters": [ { "description": "ISO country code", "in": "query", "name": "country_code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Country VAT Rate", "tags": [ "finance", "global", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/vat/NO", "x-examples": { "Estonia VAT rate": "curl https://nordapi.ee/api/v1/vat/EE", "Germany VAT rate": "curl https://nordapi.ee/api/v1/vat/DE", "Norway VAT rate": "curl https://nordapi.ee/api/v1/vat/NO" } } }, "/api/v1/shopping/upcoming": { "get": { "description": "Get the next upcoming global shopping events and sale holidays, such as Black Friday, Cyber Monday, Amazon Prime Day, Singles Day (11.11), Boxing Day, and more. Optionally filter by country for region-specific events. Useful for e-commerce platforms planning promotions, deal-tracking apps, marketing calendar tools, and retail analytics dashboards.", "operationId": "world_shopping_upcoming", "parameters": [ { "description": "Country", "in": "query", "name": "country", "required": false, "schema": { "type": "string" } }, { "description": "Limit", "in": "path", "name": "limit", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Upcoming Shopping Events", "tags": [ "world", "global", "business", "reference", "lookup", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/shopping/upcoming?country=US\"", "x-examples": { "Next 3 UK shopping events": "curl \"https://nordapi.ee/api/v1/shopping/upcoming?country=GB&limit=3\"", "Upcoming US shopping events": "curl \"https://nordapi.ee/api/v1/shopping/upcoming?country=US\"", "Upcoming global shopping events": "curl \"https://nordapi.ee/api/v1/shopping/upcoming\"" } } }, "/api/v1/fun/quote": { "get": { "description": "Get a random inspirational, motivational, or thought-provoking quote with its author attribution. Every call returns a different quote from a large collection spanning famous thinkers, leaders, authors, and public figures. Perfect for quote-of-the-day features, motivational apps, social media sharing, and adding wisdom to loading screens or empty states.", "operationId": "entertainment_fun_quote", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Quote", "tags": [ "entertainment", "global", "computed", "zenquotes", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/fun/quote", "x-examples": {} } }, "/api/v1/tallinn/info": { "get": { "description": "Complete Tallinn city reference: emergency services (police, fire, ambulance), hospitals with addresses, city districts with populations, public transport info, waste management, parking zones, and libraries. Everything in one response.", "operationId": "estonia_tallinn_info", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn City Reference", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-info", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/info", "x-examples": {} } }, "/api/v1/estonian-health/flu": { "get": { "description": "Seasonal flu vaccination data by location and age group in Estonia.", "operationId": "estonia_ee_flu", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } }, { "description": "Offset", "in": "query", "name": "offset", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Flu Vaccination", "tags": [ "estonia", "baltic", "health", "lookup", "tehik", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-health/flu?limit=10\"", "x-examples": {} } }, "/api/v1/estonian-research/researchers/{id}": { "get": { "description": "Get detailed profile of a specific researcher by ETIS ID.", "operationId": "estonia_ee_researcher", "parameters": [ { "description": "ETIS researcher ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Researcher Details", "tags": [ "estonia", "baltic", "research", "reference", "lookup", "etis", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-research/researchers/1", "x-examples": {} } }, "/api/v1/tallinn/transport/vehicles": { "get": { "description": "Real-time GPS positions of all Tallinn public transport vehicles — buses, trams, trolleybuses, and trains. Returns vehicle type, line number, coordinates, direction, vehicle ID, and nearest stop. Data from transport.tallinn.ee. Filter by type: bus, tram, trolleybus.", "operationId": "estonia_tallinn_vehicles", "parameters": [ { "description": "Filter by vehicle type: bus, tram, trolleybus, train", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Live Vehicles", "tags": [ "estonia", "baltic", "transport", "civic", "realtime", "tlt", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/transport/vehicles", "x-examples": {} } }, "/api/v1/words/adjectives/{noun}": { "get": { "description": "Find adjectives commonly used to describe a given noun. Great for creative writing and content generation.", "operationId": "language_words_adjectives", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Adjectives for Noun", "tags": [ "language", "global", "lookup", "datamuse", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/words/adjectives/ocean", "x-examples": {} } }, "/api/v1/federal/search": { "get": { "description": "Search US Federal Register documents by keyword. Returns matching rules, notices, and other government documents.", "operationId": "government_federal_search", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } }, { "description": "Results per page", "in": "query", "name": "per_page", "required": false, "schema": { "default": "10", "type": "string" } }, { "description": "Filter by document type", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Federal Register", "tags": [ "government", "united-states", "americas", "legal", "civic", "search", "federal-register", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/federal/search?q=climate+energy\"", "x-examples": {} } }, "/api/v1/timeseries": { "get": { "description": "Get daily exchange rates for every day within a specified date range. Returns a map of dates to rate objects, perfect for plotting exchange rate charts and trend lines, performing time-series analysis, or calculating moving averages. Supports filtering by base currency and target symbols to keep response sizes manageable over longer date ranges.", "operationId": "finance_timeseries", "parameters": [ { "description": "Start date", "in": "query", "name": "start_date", "required": true, "schema": { "type": "string" } }, { "description": "End date", "in": "query", "name": "end_date", "required": true, "schema": { "type": "string" } }, { "description": "Base currency", "in": "query", "name": "base", "required": false, "schema": { "type": "string" } }, { "description": "Target currencies", "in": "query", "name": "symbols", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Time Series", "tags": [ "finance", "global", "snapshot-history", "frankfurter", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/timeseries?start_date=2026-03-01&end_date=2026-03-15&base=USD&symbols=EUR\"", "x-examples": { "All rates for GBP over a week": "curl \"https://nordapi.ee/api/v1/timeseries?start_date=2026-03-17&end_date=2026-03-24&base=GBP\"", "NOK against multiple currencies over a month": "curl \"https://nordapi.ee/api/v1/timeseries?start_date=2026-02-01&end_date=2026-02-28&base=NOK&symbols=SEK,DKK\"", "USD/EUR rate over two weeks": "curl \"https://nordapi.ee/api/v1/timeseries?start_date=2026-03-01&end_date=2026-03-15&base=USD&symbols=EUR\"" } } }, "/api/v1/cocktails/categories": { "get": { "description": "List all available cocktail categories (e.g., Ordinary Drink, Cocktail, Shot, Punch/Party Drink, Coffee/Tea, Homemade Liqueur). Use these to build filtered cocktail browsing by drink type. Data from TheCocktailDB.", "operationId": "entertainment_cocktails_categories", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cocktail Categories", "tags": [ "entertainment", "global", "drinks", "food", "lookup", "cocktaildb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/cocktails/categories", "x-examples": {} } }, "/api/v1/crypto/prices": { "get": { "description": "Get current prices, market capitalization, 24-hour trading volume, and 24h/7d percentage changes for the top 250 cryptocurrencies by market cap. Data sourced from CoinGecko and updated frequently. Configurable limit parameter lets you fetch just the top 5 or up to 250 coins. Essential for crypto portfolio trackers, market overview dashboards, and price alert systems.", "operationId": "finance_crypto_prices", "parameters": [ { "description": "Number of coins (max 250)", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Crypto Prices", "tags": [ "finance", "global", "crypto", "realtime", "coingecko", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/crypto/prices?limit=5", "x-examples": { "Top 100 (default)": "curl \"https://nordapi.ee/api/v1/crypto/prices\"", "Top 250 cryptocurrencies": "curl \"https://nordapi.ee/api/v1/crypto/prices?limit=250\"", "Top 5 cryptocurrencies": "curl \"https://nordapi.ee/api/v1/crypto/prices?limit=5\"" } } }, "/api/v1/estonian-roads/bridges": { "get": { "description": "Bridge locations on Estonian roads with road name, road number, and kilometer position.", "operationId": "estonia_ee_bridges", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Bridges", "tags": [ "estonia", "baltic", "transport", "lookup", "transpordiamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-roads/bridges", "x-examples": {} } }, "/api/v1/recipes/area/{area}": { "get": { "description": "Get all recipes from a specific cuisine/region (e.g., Japanese, Italian, Mexican). Returns recipe names and thumbnails for each match. Useful for building cuisine-focused recipe collections, cultural food exploration features, and travel apps that showcase local dishes from a destination country. Data from TheMealDB.", "operationId": "entertainment_recipes_area", "parameters": [ { "description": "Cuisine region", "in": "query", "name": "area", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Meals by Cuisine", "tags": [ "entertainment", "global", "food", "lookup", "themealdb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/recipes/area/Japanese", "x-examples": { "Italian cuisine recipes": "curl https://nordapi.ee/api/v1/recipes/area/Italian", "Japanese cuisine recipes": "curl https://nordapi.ee/api/v1/recipes/area/Japanese", "Mexican cuisine recipes": "curl https://nordapi.ee/api/v1/recipes/area/Mexican" } } }, "/api/v1/fluctuation": { "get": { "description": "Calculate how exchange rates changed between two specific dates, returning the start rate, end rate, absolute change, and percentage change for each currency pair. Useful for financial reports showing currency movement, alerting systems that track FX volatility, and dashboards that display how currencies performed over a given period.", "operationId": "finance_fluctuation", "parameters": [ { "description": "Start date", "in": "query", "name": "start_date", "required": true, "schema": { "type": "string" } }, { "description": "End date", "in": "query", "name": "end_date", "required": true, "schema": { "type": "string" } }, { "description": "Base currency", "in": "query", "name": "base", "required": false, "schema": { "type": "string" } }, { "description": "Target currencies", "in": "query", "name": "symbols", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Fluctuation / Change", "tags": [ "finance", "global", "computed", "frankfurter", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/fluctuation?start_date=2026-03-19&end_date=2026-03-20&base=EUR&symbols=USD,GBP\"", "x-examples": { "All currency changes over a week": "curl \"https://nordapi.ee/api/v1/fluctuation?start_date=2026-03-17&end_date=2026-03-24&base=EUR\"", "EUR vs USD and GBP over one day": "curl \"https://nordapi.ee/api/v1/fluctuation?start_date=2026-03-19&end_date=2026-03-20&base=EUR&symbols=USD,GBP\"", "USD vs Nordic currencies over a month": "curl \"https://nordapi.ee/api/v1/fluctuation?start_date=2026-02-01&end_date=2026-03-01&base=USD&symbols=NOK,SEK,DKK\"" } } }, "/api/v1/estonian-research/institutions": { "get": { "description": "List all R&D institutions registered in the ETIS system.", "operationId": "estonia_ee_institutions", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Research Institutions", "tags": [ "estonia", "baltic", "research", "reference", "lookup", "etis", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-research/institutions", "x-examples": {} } }, "/api/v1/estonian-roads/speed-cameras": { "get": { "description": "All 72 speed enforcement camera locations in Estonia with road name, speed limit, kilometer position, and direction. Essential for navigation apps and driver information.", "operationId": "estonia_ee_speed_cameras", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Speed Cameras", "tags": [ "estonia", "baltic", "transport", "lookup", "transpordiamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-roads/speed-cameras", "x-examples": {} } }, "/api/v1/tallinn/free": { "get": { "description": "Free activities and events in Tallinn: always-free attractions (Old Town, Kadriorg Park, Pirita Beach), seasonal events (Christmas Market, Maritime Days, Medieval Days), and weekly free days (museum Sundays, KUMU Thursdays, free parking Sundays).", "operationId": "estonia_tallinn_free", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Free Things in Tallinn", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-life", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/free", "x-examples": {} } }, "/api/v1/recipes/search": { "get": { "description": "Search for meal recipes by name or ingredient keyword. Returns matching recipes with names, thumbnail images, categories, and cuisine regions. Data from TheMealDB, covering hundreds of recipes from around the world. Useful for cooking apps, meal planning tools, recipe discovery features, and food blogs that need structured recipe data.", "operationId": "entertainment_recipes_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Recipe Search", "tags": [ "entertainment", "global", "food", "search", "themealdb", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/recipes/search?q=pasta\"", "x-examples": { "Search for chicken recipes": "curl \"https://nordapi.ee/api/v1/recipes/search?q=chicken\"", "Search for chocolate desserts": "curl \"https://nordapi.ee/api/v1/recipes/search?q=chocolate+cake\"", "Search for pasta recipes": "curl \"https://nordapi.ee/api/v1/recipes/search?q=pasta\"" } } }, "/api/v1/carbon/flight": { "get": { "description": "Calculate the CO2 emissions for a specific flight route by providing origin and destination coordinates. Uses great-circle distance and aviation emission factors to estimate the carbon footprint in kilograms of CO2. Useful for travel booking apps that display environmental impact, carbon offset calculators, and corporate travel sustainability reporting. Supports any two points on Earth.", "operationId": "science_carbon_flight", "parameters": [ { "description": "Origin lat", "in": "query", "name": "from_lat", "required": true, "schema": { "type": "string" } }, { "description": "Origin lon", "in": "query", "name": "from_lon", "required": true, "schema": { "type": "string" } }, { "description": "Dest lat", "in": "query", "name": "to_lat", "required": true, "schema": { "type": "string" } }, { "description": "Dest lon", "in": "query", "name": "to_lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Flight Carbon Footprint", "tags": [ "science", "global", "environment", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/carbon/flight?from_lat=59.9&from_lon=10.7&to_lat=40.7&to_lon=-74\"", "x-examples": { "London to Tokyo flight emissions": "curl \"https://nordapi.ee/api/v1/carbon/flight?from_lat=51.47&from_lon=-0.46&to_lat=35.76&to_lon=140.39\"", "Oslo to New York flight emissions": "curl \"https://nordapi.ee/api/v1/carbon/flight?from_lat=59.9&from_lon=10.7&to_lat=40.7&to_lon=-74\"", "Stockholm to Berlin flight emissions": "curl \"https://nordapi.ee/api/v1/carbon/flight?from_lat=59.65&from_lon=17.92&to_lat=52.56&to_lon=13.29\"" } } }, "/api/v1/anime/search": { "get": { "description": "Search for anime series or manga by title using the Jikan API (unofficial MyAnimeList API). Returns titles, synopses, ratings, episode counts, airing status, genres, and cover images. Supports searching both anime and manga with the type parameter. Useful for anime discovery apps, watchlist builders, and otaku community platforms.", "operationId": "entertainment_anime_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } }, { "description": "anime or manga", "in": "path", "name": "type", "required": true, "schema": { "default": "anime", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Anime Search", "tags": [ "entertainment", "global", "anime", "search", "jikan", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/anime/search?q=naruto\"", "x-examples": { "Search for Attack on Titan": "curl \"https://nordapi.ee/api/v1/anime/search?q=attack+on+titan\"", "Search for Naruto anime": "curl \"https://nordapi.ee/api/v1/anime/search?q=naruto\"", "Search for manga by name": "curl \"https://nordapi.ee/api/v1/anime/search?q=one+piece&type=manga\"" } } }, "/api/v1/nasa/apod": { "get": { "description": "Get NASA's Astronomy Picture of the Day (APOD), featuring a stunning space image or video along with a professional astronomer's explanation. Optionally specify a date to retrieve past entries. Running since 1995, APOD is one of the most popular science outreach programs. Ideal for science education apps, daily content feeds, desktop wallpaper apps, and space enthusiast communities.", "operationId": "science_nasa_apod", "parameters": [ { "description": "Date", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Astronomy Picture of the Day", "tags": [ "science", "global", "space", "astronomy", "lookup", "apod", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/nasa/apod", "x-examples": { "Picture from a specific date": "curl \"https://nordapi.ee/api/v1/nasa/apod?date=2026-01-01\"", "Picture from the Moon landing anniversary": "curl \"https://nordapi.ee/api/v1/nasa/apod?date=2025-07-20\"", "Today's astronomy picture": "curl https://nordapi.ee/api/v1/nasa/apod" } } }, "/api/v1/starwars/people/{id}": { "get": { "description": "Get detailed information about a specific Star Wars character by their SWAPI ID. Returns the character's name, birth year, height, mass, hair color, skin color, eye color, gender, homeworld details, and a list of films they appear in. Use this for building character profile pages, Star Wars databases, and detailed character cards in fan applications.", "operationId": "entertainment_starwars_person", "parameters": [ { "description": "SWAPI person ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Star Wars Person Detail", "tags": [ "entertainment", "global", "movies", "lookup", "star-wars-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/starwars/people/1", "x-examples": { "Darth Vader (ID 4)": "curl https://nordapi.ee/api/v1/starwars/people/4", "Leia Organa (ID 5)": "curl https://nordapi.ee/api/v1/starwars/people/5", "Luke Skywalker (ID 1)": "curl https://nordapi.ee/api/v1/starwars/people/1" } } }, "/api/v1/countrydata/{code}": { "get": { "description": "Get the complete profile for a single country by its ISO 3166-1 alpha-2 code. Returns official name, capital, population, area, languages, currencies, calling codes, borders, region, subregion, and more. More efficient than fetching all 250 countries when you only need one. Ideal for country detail pages and deep-dive geographic content.", "operationId": "geo_countrydata_show", "parameters": [ { "description": "Country code", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Country Detail", "tags": [ "geo", "global", "geography", "reference", "lookup", "rest-countries", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/countrydata/NO", "x-examples": { "Brazil full profile": "curl https://nordapi.ee/api/v1/countrydata/BR", "Japan full profile": "curl https://nordapi.ee/api/v1/countrydata/JP", "Norway full profile": "curl https://nordapi.ee/api/v1/countrydata/NO" } } }, "/api/v1/elering/prices/today": { "get": { "description": "Today's hourly electricity prices for Estonia, Finland, Latvia, and Lithuania. Convenience endpoint — no date params needed.", "operationId": "estonia_elering_today", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Today's Baltic Electricity Prices", "tags": [ "estonia", "baltic", "power", "scheduled", "elering", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/elering/prices/today", "x-examples": {} } }, "/api/v1/link/screenshot": { "get": { "description": "Extract metadata from a URL plus capture a screenshot image. Returns the same data as link preview with an additional screenshot URL.", "operationId": "texttools_link_screenshot", "parameters": [ { "description": "URL to screenshot", "in": "query", "name": "url", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "URL Screenshot", "tags": [ "texttools", "global", "tools", "text", "lookup", "microlink", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/link/screenshot?url=https://github.com\"", "x-examples": {} } }, "/api/v1/tallinn/data/road-closures": { "get": { "description": "Current and planned road closures and construction works in Tallinn.", "operationId": "estonia_tallinn_road_closures", "parameters": [ { "description": "Results per page", "in": "query", "name": "per_page", "required": false, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Road Closures", "tags": [ "estonia", "baltic", "transport", "civic", "lookup", "avaandmed-tallinn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/data/road-closures", "x-examples": {} } }, "/api/v1/convert": { "get": { "description": "Convert a specific monetary amount from one currency to another using the latest exchange rates. Supports an optional margin parameter for adding business markup (e.g., 2% fee on top of the market rate), and an optional date parameter for historical conversions. Returns the converted amount, the rate used, and query details. Perfect for e-commerce checkout flows, invoicing systems, and travel budget tools.", "operationId": "finance_convert", "parameters": [ { "description": "Source currency", "in": "query", "name": "from", "required": true, "schema": { "type": "string" } }, { "description": "Target currency", "in": "query", "name": "to", "required": true, "schema": { "type": "string" } }, { "description": "Amount to convert", "in": "query", "name": "amount", "required": true, "schema": { "type": "string" } }, { "description": "Business markup percentage", "in": "query", "name": "margin", "required": false, "schema": { "type": "string" } }, { "description": "Historical date (YYYY-MM-DD)", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Convert Currency", "tags": [ "finance", "global", "computed", "frankfurter", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/convert?from=USD&to=EUR&amount=100\"", "x-examples": { "Convert USD to Euro": "curl \"https://nordapi.ee/api/v1/convert?from=USD&to=EUR&amount=100\"", "Convert with 2.5% business markup": "curl \"https://nordapi.ee/api/v1/convert?from=USD&to=EUR&amount=100&margin=2.5\"", "Historical conversion on a specific date": "curl \"https://nordapi.ee/api/v1/convert?from=GBP&to=NOK&amount=500&date=2026-01-15\"", "Large amount JPY to NOK": "curl \"https://nordapi.ee/api/v1/convert?from=JPY&to=NOK&amount=1000000\"" } } }, "/api/v1/pokemon/{name}": { "get": { "description": "Get complete data for any Pokemon by name or Pokedex number. Returns types, abilities, base stats (HP/Attack/Defense/Speed), height, weight, sprite images (front/back/shiny/official artwork), and move count. Data from PokeAPI.", "operationId": "entertainment_pokemon_show", "parameters": [ { "description": "Pokemon name or Pokedex number", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Pokemon Details", "tags": [ "entertainment", "global", "games", "lookup", "pokeapi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/pokemon/pikachu", "x-examples": { "Look up Charizard": "curl https://nordapi.ee/api/v1/pokemon/charizard", "Look up Pikachu": "curl https://nordapi.ee/api/v1/pokemon/pikachu", "Look up by Pokedex number": "curl https://nordapi.ee/api/v1/pokemon/25" } } }, "/api/v1/tv/schedule": { "get": { "description": "Get today's TV broadcast schedule for a specific country, showing which episodes are airing and when. Returns show names, episode titles, air times, seasons, episode numbers, and network information. Defaults to the US schedule. Useful for TV guide apps, entertainment dashboards, and 'what's on tonight' features. Data from TVMaze.", "operationId": "entertainment_tv_schedule", "parameters": [ { "description": "Country", "in": "query", "name": "country", "required": false, "schema": { "default": "US", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "TV Schedule", "tags": [ "entertainment", "global", "tv", "scheduled", "tvmaze", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/tv/schedule?country=US\"", "x-examples": { "Norwegian TV schedule today": "curl \"https://nordapi.ee/api/v1/tv/schedule?country=NO\"", "UK TV schedule today": "curl \"https://nordapi.ee/api/v1/tv/schedule?country=GB\"", "US TV schedule today": "curl \"https://nordapi.ee/api/v1/tv/schedule?country=US\"" } } }, "/api/v1/space/launches/upcoming": { "get": { "description": "Get a list of scheduled upcoming rocket launches from around the world, including mission names, launch providers, rocket types, planned launch dates, and launch sites. Covers all major space agencies (NASA, ESA, JAXA) and private companies (SpaceX, Rocket Lab, Blue Origin). Useful for launch countdown apps, space event calendars, and aerospace enthusiast communities.", "operationId": "science_space_upcoming", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Upcoming Launches", "tags": [ "science", "global", "space", "scheduled", "spacexdata", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/space/launches/upcoming", "x-examples": {} } }, "/api/v1/cards/quickdraw": { "get": { "description": "Create a new deck and immediately draw cards in one request. Perfect for quick card game prototyping.", "operationId": "gaming_cards_quickdraw", "parameters": [ { "description": "Number of cards to draw", "in": "query", "name": "count", "required": false, "schema": { "default": "5", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Quick Draw", "tags": [ "gaming", "global", "games", "computed", "deck-of-cards", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/cards/quickdraw?count=5\"", "x-examples": {} } }, "/api/v1/recipes/category/{category}": { "get": { "description": "Get all recipes in a specific meal category (e.g., Seafood, Vegetarian, Dessert). Returns recipe names and thumbnails for each match. Useful for building category landing pages in cooking apps, dietary-filtered meal lists, and recipe browsing interfaces organized by food type. Data from TheMealDB.", "operationId": "entertainment_recipes_category", "parameters": [ { "description": "Category", "in": "path", "name": "category", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Meals by Category", "tags": [ "entertainment", "global", "food", "lookup", "themealdb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/recipes/category/Seafood", "x-examples": { "All seafood recipes": "curl https://nordapi.ee/api/v1/recipes/category/Seafood", "Dessert recipes": "curl https://nordapi.ee/api/v1/recipes/category/Dessert", "Vegetarian recipes": "curl https://nordapi.ee/api/v1/recipes/category/Vegetarian" } } }, "/api/v1/mashup/remote/optimize": { "get": { "description": "Find the best countries for remote work based on your salary, employer timezone, and minimum overlap hours. Combines timezone compatibility, purchasing power parity, cost of living, internet infrastructure, and quality of life metrics to rank potential remote work destinations. Returns a scored list of countries with detailed breakdowns. Essential for remote workers choosing where to live, HR teams building remote work policies, and digital nomad platforms helping users find optimal locations.", "operationId": "mashups_remote_optimize", "parameters": [ { "description": "Annual salary amount", "in": "query", "name": "salary", "required": true, "schema": { "type": "string" } }, { "description": "Salary currency code", "in": "query", "name": "currency", "required": true, "schema": { "type": "string" } }, { "description": "Employer timezone (e.g., America/New_York)", "in": "query", "name": "employer_tz", "required": true, "schema": { "type": "string" } }, { "description": "Minimum overlap hours with employer", "in": "query", "name": "min_overlap", "required": false, "schema": { "default": "4", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Remote Work Optimizer", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/remote/optimize?salary=100000¤cy=USD&employer_tz=America/New_York\"", "x-examples": { "Optimize for London employer with 6-hour overlap": "curl \"https://nordapi.ee/api/v1/mashup/remote/optimize?salary=70000¤cy=GBP&employer_tz=Europe/London&min_overlap=6\"", "Optimize for Norwegian employer": "curl \"https://nordapi.ee/api/v1/mashup/remote/optimize?salary=800000¤cy=NOK&employer_tz=Europe/Oslo\"", "Optimize for US-based remote worker": "curl \"https://nordapi.ee/api/v1/mashup/remote/optimize?salary=100000¤cy=USD&employer_tz=America/New_York\"" } } }, "/api/v1/mashup/shopping/optimize": { "get": { "description": "Find the best country to shop in based on your budget, comparing currency exchange rates, local purchasing power, active shopping events, and VAT rates across multiple target countries. Enter your budget, currency, and a list of countries to compare. Returns a ranked list showing where your money goes furthest, factoring in current sales events and tax rates. Ideal for cross-border e-commerce platforms, travel shopping guides, and deal-hunting apps.", "operationId": "mashups_shopping_optimize", "parameters": [ { "description": "Shopping budget amount", "in": "query", "name": "budget", "required": true, "schema": { "type": "string" } }, { "description": "Budget currency code", "in": "query", "name": "currency", "required": true, "schema": { "type": "string" } }, { "description": "Comma-separated country codes to compare", "in": "query", "name": "countries", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Shopping Optimizer", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/shopping/optimize?budget=1000¤cy=USD&countries=DE,JP,GB\"", "x-examples": { "Optimize $1000 shopping across Europe and Japan": "curl \"https://nordapi.ee/api/v1/mashup/shopping/optimize?budget=1000¤cy=USD&countries=DE,JP,GB\"", "Optimize EUR 2000 for luxury shopping destinations": "curl \"https://nordapi.ee/api/v1/mashup/shopping/optimize?budget=2000¤cy=EUR&countries=IT,FR,US,AE\"", "Optimize NOK 5000 across Nordic countries": "curl \"https://nordapi.ee/api/v1/mashup/shopping/optimize?budget=5000¤cy=NOK&countries=SE,DK,FI\"" } } }, "/api/v1/radio/tags": { "get": { "description": "List the most popular genre tags used by internet radio stations (e.g., jazz, rock, classical, electronic, pop, news, talk). Returns tag names and station counts. Useful for building genre-based radio browsing menus, tag clouds, and helping users filter the 45,000+ stations down to their preferred music style. Data from Radio Browser.", "operationId": "entertainment_radio_tags", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Radio Genres", "tags": [ "entertainment", "global", "music", "lookup", "radio-browser", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/radio/tags", "x-examples": {} } }, "/api/v1/maaamet/search": { "get": { "description": "Search Estonian addresses using the Maa-amet Land Board geocoding service (ADS - Address Data System). Returns full address, county, municipality, zip code, and WGS84 coordinates. Covers all of Estonia.", "operationId": "estonia_maaamet_search", "parameters": [ { "description": "Address query (e.g. Narva mnt 7, Tallinn)", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } }, { "description": "Max results", "in": "query", "name": "results", "required": false, "schema": { "default": "10", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Address Search", "tags": [ "estonia", "baltic", "geography", "search", "maa-amet", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/maaamet/search?q=Narva+mnt+7+Tallinn\"", "x-examples": {} } }, "/api/v1/jobs/search": { "get": { "description": "Browse current remote job listings from companies hiring for remote positions. Returns job titles, company names, posting dates, and application URLs. Useful for building job boards, career pages, remote work aggregators, and employment trend analysis tools. Provides a curated feed of verified remote opportunities.", "operationId": "world_jobs", "parameters": [ { "description": "Limit", "in": "path", "name": "limit", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Remote Job Listings", "tags": [ "world", "global", "business", "reference", "search", "himalayas", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/jobs/search", "x-examples": { "Latest remote job listings": "curl https://nordapi.ee/api/v1/jobs/search", "Top 5 remote jobs": "curl \"https://nordapi.ee/api/v1/jobs/search?limit=5\"" } } }, "/api/v1/tallinn/cameras": { "get": { "description": "255 live traffic intersection cameras across all Tallinn districts. Each camera returns a name, ID, live image URL (updated every few seconds), and AI-estimated calibration data (pitch, roll, FOV, compass heading, sky visibility percentage). Calibration uses GeoCalib neural network + solar shadow analysis. Filter by district or road corridor.", "operationId": "estonia_tallinn_cameras", "parameters": [ { "description": "Filter by area tag: KE, LA, NO, KR, MU, HA, PT, PI (districts) or 1-19 (road corridors)", "in": "query", "name": "area", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Traffic Cameras", "tags": [ "estonia", "baltic", "cameras", "transport", "realtime", "tallinn-cameras", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/tallinn/cameras?area=KE\"", "x-examples": {} } }, "/api/v1/harrypotter/house/{house}": { "get": { "description": "Get all characters belonging to a specific Hogwarts house: Gryffindor, Slytherin, Hufflepuff, or Ravenclaw. Returns character names, ancestry, patronus, actor, and wand details for each house member. Useful for house pride features, sorting hat apps, house comparison tools, and fan community platforms organized by Hogwarts house. Data from the HP-API.", "operationId": "entertainment_harrypotter_house", "parameters": [ { "description": "Hogwarts house (gryffindor, slytherin, hufflepuff, ravenclaw)", "in": "query", "name": "house", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Harry Potter House Members", "tags": [ "entertainment", "global", "movies", "lookup", "hp-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/harrypotter/house/gryffindor", "x-examples": { "All Gryffindor members": "curl https://nordapi.ee/api/v1/harrypotter/house/gryffindor", "All Hufflepuff members": "curl https://nordapi.ee/api/v1/harrypotter/house/hufflepuff", "All Ravenclaw members": "curl https://nordapi.ee/api/v1/harrypotter/house/ravenclaw", "All Slytherin members": "curl https://nordapi.ee/api/v1/harrypotter/house/slytherin" } } }, "/api/v1/marine/forecast": { "get": { "description": "Get a multi-day marine weather forecast with hourly wave height, wave direction, wave period, and swell predictions. Configurable up to 7 days ahead. Useful for planning sailing routes, scheduling offshore work, timing surf sessions, and building marine safety alerting systems. Data from Open-Meteo marine forecast models.", "operationId": "geo_marine_forecast", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } }, { "description": "Days", "in": "query", "name": "days", "required": false, "schema": { "default": "7", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Marine Forecast", "tags": [ "geo", "global", "weather", "realtime", "open-meteo", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/marine/forecast?lat=59.9&lon=10.7\"", "x-examples": { "3-day surf forecast for Bali": "curl \"https://nordapi.ee/api/v1/marine/forecast?lat=-8.72&lon=115.17&days=3\"", "5-day forecast for North Sea": "curl \"https://nordapi.ee/api/v1/marine/forecast?lat=56.0&lon=3.0&days=5\"", "7-day marine forecast for Oslo Fjord": "curl \"https://nordapi.ee/api/v1/marine/forecast?lat=59.9&lon=10.7\"" } } }, "/api/v1/iss/position": { "get": { "description": "Get the International Space Station's current position with enhanced detail, including latitude, longitude, altitude above sea level, and orbital velocity. Provides more technical orbital data than the basic ISS location endpoint. Useful for advanced ISS tracking applications, satellite visualization tools, and educational apps that demonstrate orbital mechanics concepts.", "operationId": "science_iss_position", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "ISS Detailed Position", "tags": [ "science", "global", "space", "realtime", "wheretheiss-at", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/iss/position", "x-examples": {} } }, "/api/v1/mashup/salary/compare": { "get": { "description": "Compare what a salary is worth across different countries after adjusting for purchasing power parity (PPP). Enter a salary amount and origin country, and get the PPP-equivalent salary in multiple target countries. A $100K US salary might have the purchasing power of $60K in Norway due to higher costs, or $150K in Thailand due to lower costs. Essential for remote work negotiations, relocation planning, and HR tools setting international pay scales.", "operationId": "mashups_salary_compare", "parameters": [ { "description": "Salary", "in": "query", "name": "amount", "required": true, "schema": { "type": "string" } }, { "description": "Origin country", "in": "query", "name": "from", "required": true, "schema": { "type": "string" } }, { "description": "Target countries (comma-sep)", "in": "query", "name": "to", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Salary Comparator", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/salary/compare?amount=85000&from=US&to=NO,TH,DE\"", "x-examples": { "Compare $85K US salary across countries": "curl \"https://nordapi.ee/api/v1/mashup/salary/compare?amount=85000&from=US&to=NO,TH,DE\"", "Compare Norwegian salary to European countries": "curl \"https://nordapi.ee/api/v1/mashup/salary/compare?amount=600000&from=NO&to=SE,DK,DE,GB\"", "Compare UK salary to Asian markets": "curl \"https://nordapi.ee/api/v1/mashup/salary/compare?amount=50000&from=GB&to=JP,SG,IN\"" } } }, "/api/v1/estonian-trademarks": { "get": { "description": "Search 127,000+ trademarks from the Estonian Patent Office (EPA). Returns registration numbers, dates, status, owner, and mark type. Proxied from andmebaas.epa.ee REST API.", "operationId": "estonia_ee_trademarks", "parameters": [ { "description": "Search by trademark name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } }, { "description": "Filter by owner name", "in": "query", "name": "owner", "required": false, "schema": { "type": "string" } }, { "description": "Filter by status (e.g. Registered, Expired)", "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "description": "Mark kind (e.g. Figurative-word, Word)", "in": "query", "name": "kind", "required": false, "schema": { "type": "string" } }, { "description": "Results per page (max 100)", "in": "path", "name": "limit", "required": true, "schema": { "default": "20", "type": "string" } }, { "description": "Page number", "in": "query", "name": "page", "required": false, "schema": { "default": "0", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Trademarks", "tags": [ "estonia", "baltic", "business", "legal", "search", "epa-andmebaas", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/estonian-trademarks?name=Estonia\"", "x-examples": {} } }, "/api/v1/estonian-environment/messages": { "get": { "description": "System messages and notifications from the KESE environmental monitoring platform. Includes data publication notices and system updates.", "operationId": "estonia_ee_env_messages", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Environmental Monitoring Messages", "tags": [ "estonia", "baltic", "environment", "lookup", "kese-envir", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-environment/messages", "x-examples": {} } }, "/api/v1/geo/ip/{ip}": { "get": { "description": "Geolocate any specific IPv4 or IPv6 address. Returns approximate latitude/longitude, city, region, country, timezone, and ISP information for the given IP. Useful for looking up the location of server IPs, investigating suspicious login attempts, enriching log data with geographic context, and building IP-based access control systems.", "operationId": "geo_geo_ip_lookup", "parameters": [ { "description": "IP address", "in": "query", "name": "ip", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "IP Geolocation (Specific)", "tags": [ "geo", "global", "geography", "lookup", "ip-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/geo/ip/8.8.8.8", "x-examples": { "Cloudflare DNS server location": "curl https://nordapi.ee/api/v1/geo/ip/1.1.1.1", "Google DNS server location": "curl https://nordapi.ee/api/v1/geo/ip/8.8.8.8", "Locate a specific IP": "curl https://nordapi.ee/api/v1/geo/ip/93.184.216.34" } } }, "/api/v1/estonian-border/queue": { "get": { "description": "Real-time vehicle queue data at all 3 Estonia-Russia border crossings: Narva, Koidula, Luhamaa. Returns vehicles in queue, vehicles arrived today, and estimated crossing times. Includes current status notes (Narva bridge closed, nighttime restrictions at Koidula/Luhamaa). Scraped from GoSwift (eestipiir.ee).", "operationId": "estonia_border_queue", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonia-Russia Border Queue", "tags": [ "estonia", "baltic", "transport", "travel", "realtime", "eestipiir", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-border/queue", "x-examples": {} } }, "/api/v1/riigikogu/votings/{uuid}": { "get": { "description": "Get full details of a specific parliamentary vote by UUID, including individual member votes. UUIDs are returned by the votings list endpoints.", "operationId": "estonia_riigikogu_voting", "parameters": [ { "description": "Language: en or et", "in": "query", "name": "lang", "required": false, "schema": { "default": "en", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Riigikogu Voting Detail", "tags": [ "estonia", "baltic", "civic", "legal", "lookup", "riigikogu", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/riigikogu/votings/db57ca8d-7fe4-44cb-ab47-a68e46a683d5", "x-examples": {} } }, "/api/v1/poetry/author/{author}": { "get": { "description": "Get all poems by a specific author. Returns up to 10 poems with full text.", "operationId": "language_poetry_author", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Poems by Author", "tags": [ "language", "global", "poetry", "lookup", "poetrydb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/poetry/author/Shakespeare", "x-examples": {} } }, "/api/v1/tallinn/city-reports": { "get": { "description": "1,574 citizen problem reports from annateada.ee with GPS coordinates.", "operationId": "estonia_ee_city_reports", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn City Reports", "tags": [ "estonia", "baltic", "civic", "lookup", "annateada", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/city-reports", "x-examples": {} } }, "/api/v1/estonian-roads/weather": { "get": { "description": "Real-time road weather data from stations across Estonia. Returns road/air temperature, precipitation type and intensity, wind speed/direction, humidity, visibility, and road surface status.", "operationId": "estonia_ee_road_weather", "parameters": [ { "description": "Max results", "in": "path", "name": "limit", "required": true, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Road Weather Stations", "tags": [ "estonia", "baltic", "transport", "weather", "realtime", "transpordiamet", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-roads/weather", "x-examples": {} } }, "/api/v1/mashup/currency/health": { "get": { "description": "Get a comprehensive health assessment for any supported currency, combining exchange rate trends, volatility metrics, economic indicators of the issuing country, and comparative performance against major currencies. Returns a health score with detailed breakdown across stability, strength, and economic fundamentals. Useful for forex traders evaluating currency risk, businesses assessing payment currency options, and financial advisors monitoring client exposure to specific currencies.", "operationId": "mashups_currency_health", "parameters": [ { "description": "Currency code (e.g., NOK, EUR, GBP)", "in": "query", "name": "currency", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Currency Health Check", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/currency/health?currency=NOK\"", "x-examples": { "Health check for Euro": "curl \"https://nordapi.ee/api/v1/mashup/currency/health?currency=EUR\"", "Health check for Japanese Yen": "curl \"https://nordapi.ee/api/v1/mashup/currency/health?currency=JPY\"", "Health check for Norwegian Krone": "curl \"https://nordapi.ee/api/v1/mashup/currency/health?currency=NOK\"" } } }, "/api/v1/dictionary/{word}": { "get": { "description": "Look up any English word to get its definitions, part of speech, phonetic transcription, audio pronunciation URL, synonyms, antonyms, and usage examples. Data from the Free Dictionary API. Useful for language learning apps, writing assistants, word-of-the-day features, crossword solvers, and any tool that needs programmatic access to English word definitions.", "operationId": "world_dictionary", "parameters": [ { "description": "Word to look up", "in": "query", "name": "word", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Dictionary Lookup", "tags": [ "world", "global", "reference", "language", "lookup", "dictionary-api-dev", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/dictionary/serendipity", "x-examples": { "Look up algorithm": "curl https://nordapi.ee/api/v1/dictionary/algorithm", "Look up ephemeral": "curl https://nordapi.ee/api/v1/dictionary/ephemeral", "Look up serendipity": "curl https://nordapi.ee/api/v1/dictionary/serendipity" } } }, "/api/v1/emoji/group/{group}": { "get": { "description": "Get all emojis in a specific sub-group (e.g., face-positive, face-negative, animal-mammal, plant-flower). Groups are finer-grained than categories, allowing more precise emoji filtering. Useful for building detailed emoji browsers and finding emojis related to very specific themes.", "operationId": "food_emoji_group", "parameters": [ { "description": "Group", "in": "query", "name": "group", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Emojis by Group", "tags": [ "food", "global", "reference", "lookup", "emojihub", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/emoji/group/face-positive", "x-examples": { "Flag emojis": "curl https://nordapi.ee/api/v1/emoji/group/flag", "Mammal emojis": "curl https://nordapi.ee/api/v1/emoji/group/animal-mammal", "Positive face emojis": "curl https://nordapi.ee/api/v1/emoji/group/face-positive" } } }, "/api/v1/names/age/{name}": { "get": { "description": "Estimate the likely age of a person based on their first name using statistical data from government records. Returns the predicted age and sample count. Names go through popularity cycles, so names popular in the 1950s suggest an older person while recently popular names suggest a younger person. Useful for demographic analysis, marketing segmentation, and user research. Data from Agify.io.", "operationId": "world_names_age", "parameters": [ { "description": "First name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Predict Age from Name", "tags": [ "world", "global", "reference", "statistics", "lookup", "agify", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/names/age/erik", "x-examples": { "Predict age for Emma": "curl https://nordapi.ee/api/v1/names/age/emma", "Predict age for Erik": "curl https://nordapi.ee/api/v1/names/age/erik", "Predict age for Walter": "curl https://nordapi.ee/api/v1/names/age/walter" } } }, "/api/v1/dnd/classes/{name}": { "get": { "description": "Get complete details for a specific D&D 5e character class by name or index key. Returns hit die, primary ability scores, saving throw proficiencies, skill choices, starting equipment, class features by level, spellcasting ability (if applicable), and subclass options. Data from the official 5e SRD via the D&D 5e API. Essential for character builders, level-up planners, and class guide generators.", "operationId": "entertainment_dnd_class", "parameters": [ { "description": "Class name or index (e.g., wizard, ranger, paladin)", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "D&D Class Detail", "tags": [ "entertainment", "global", "games", "lookup", "dnd5e-api", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/dnd/classes/wizard", "x-examples": { "Paladin class details": "curl https://nordapi.ee/api/v1/dnd/classes/paladin", "Ranger class details": "curl https://nordapi.ee/api/v1/dnd/classes/ranger", "Wizard class details": "curl https://nordapi.ee/api/v1/dnd/classes/wizard" } } }, "/api/v1/earthquakes": { "get": { "description": "Get recent earthquakes worldwide from the USGS (United States Geological Survey) seismic network. Returns location, magnitude, depth, time, and coordinates for each event. Filter by minimum magnitude (default 2.5) and limit results. Useful for seismology dashboards, natural disaster monitoring tools, safety alert systems, and educational apps about plate tectonics. Data is updated in near real-time.", "operationId": "science_earthquakes", "parameters": [ { "description": "Minimum magnitude", "in": "query", "name": "min_magnitude", "required": false, "schema": { "default": "2.5", "type": "string" } }, { "description": "Limit", "in": "path", "name": "limit", "required": true, "schema": { "default": "20", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Recent Earthquakes", "tags": [ "science", "global", "earthquakes", "realtime", "earthquakes-usgs", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/earthquakes", "x-examples": { "All earthquakes above magnitude 4": "curl \"https://nordapi.ee/api/v1/earthquakes?min_magnitude=4&limit=10\"", "Last 50 earthquakes worldwide": "curl \"https://nordapi.ee/api/v1/earthquakes?limit=50\"", "Only significant earthquakes (mag 6+)": "curl \"https://nordapi.ee/api/v1/earthquakes?min_magnitude=6\"" } } }, "/api/v1/url/shorten": { "get": { "description": "Shorten any long URL into a compact, shareable short link. Returns the shortened URL that redirects to the original. Useful for social media sharing where character count matters, generating clean links for print materials, tracking link usage, and making long URLs with many parameters more manageable and user-friendly.", "operationId": "tools_url_shorten", "parameters": [ { "description": "URL to shorten", "in": "query", "name": "url", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "URL Shortener", "tags": [ "tools", "global", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/url/shorten?url=https://nordapi.ee\"", "x-examples": { "Shorten a long GitHub URL": "curl \"https://nordapi.ee/api/v1/url/shorten?url=https://github.com/elixir-lang/elixir\"", "Shorten the NordAPI URL": "curl \"https://nordapi.ee/api/v1/url/shorten?url=https://nordapi.ee\"" } } }, "/api/v1/elering/history": { "get": { "description": "Time series of Estonian grid state snapshots (production, consumption, frequency, system balance, renewable production, solar production) collected every 5 minutes from the Elering TSO dashboard. Nobody else archives this publicly. Filter with ?start and ?end. Useful for analyzing consumption patterns, correlating grid frequency with imbalances, tracking the growth of solar capacity, and studying the impact of weather on renewable output.", "operationId": "estonia_elering_history", "parameters": [ { "description": "Start datetime", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Grid History", "tags": [ "estonia", "baltic", "power", "snapshot-history", "elering", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/elering/history?limit=288\"", "x-examples": { "Last 24 hours (288 snapshots)": "curl \"https://nordapi.ee/api/v1/elering/history?limit=288\"", "Specific day": "curl \"https://nordapi.ee/api/v1/elering/history?start=2026-04-14&end=2026-04-15\"" } } }, "/api/v1/countries/{code}": { "get": { "description": "Look up detailed currency information for a specific country by its ISO country code. Returns the country name, currency code, geographic region, and flag emoji. Useful when you know the country and need to determine its currency for conversion or display purposes, such as auto-detecting a user's currency from their country setting.", "operationId": "finance_country", "parameters": [ { "description": "ISO country code in URL", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Country Detail", "tags": [ "finance", "global", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/countries/NO", "x-examples": { "Japan country detail": "curl https://nordapi.ee/api/v1/countries/JP", "Norway country detail": "curl https://nordapi.ee/api/v1/countries/NO", "United States country detail": "curl https://nordapi.ee/api/v1/countries/US" } } }, "/api/v1/food/barcode/{barcode}": { "get": { "description": "Look up a food product by its barcode number (EAN/UPC). Returns complete product details including name, brand, nutrition facts, ingredients list, Nutri-Score, allergens, and product images. Perfect for barcode scanning apps, grocery shopping assistants, and dietary tracking tools where users scan products with their phone camera. Data from Open Food Facts.", "operationId": "food_food_barcode", "parameters": [ { "description": "Barcode", "in": "query", "name": "barcode", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Barcode Lookup", "tags": [ "food", "global", "lookup", "open-food-facts", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/food/barcode/3017620422003", "x-examples": { "Look up Nutella by barcode": "curl https://nordapi.ee/api/v1/food/barcode/3017620422003", "Look up a Coca-Cola product": "curl https://nordapi.ee/api/v1/food/barcode/5449000000996" } } }, "/api/v1/tallinn/city-reports/stats": { "get": { "description": "Aggregated statistics for city problem reports by category.", "operationId": "estonia_ee_city_report_stats", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "City Report Statistics", "tags": [ "estonia", "baltic", "civic", "computed", "annateada", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/city-reports/stats", "x-examples": {} } }, "/api/v1/barcode/generate": { "get": { "description": "Generate a barcode image URL in any supported format (Code 128, Code 39, EAN-13, UPC-A, etc.). Provide the barcode type and data to encode, and receive a URL to the rendered barcode image. Useful for inventory management systems, shipping label generators, product labeling tools, event ticket systems, and retail applications that need to create scannable barcodes programmatically.", "operationId": "tools_barcode_generate", "parameters": [ { "description": "Barcode type", "in": "path", "name": "type", "required": true, "schema": { "type": "string" } }, { "description": "Data", "in": "query", "name": "data", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Barcode Generator", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/barcode/generate?type=code128&data=NORDAPI\"", "x-examples": { "Generate Code 128 barcode": "curl \"https://nordapi.ee/api/v1/barcode/generate?type=code128&data=NORDAPI\"", "Generate Code 39 barcode": "curl \"https://nordapi.ee/api/v1/barcode/generate?type=code39&data=HELLO123\"", "Generate EAN-13 barcode": "curl \"https://nordapi.ee/api/v1/barcode/generate?type=ean13&data=5901234123457\"" } } }, "/api/v1/radio/top": { "get": { "description": "Get the most popular internet radio stations globally, ranked by listener votes and clicks. Returns station names, stream URLs, countries, genres, and popularity metrics. Useful for featuring trending stations, building curated 'best of' radio lists, and helping users discover popular stations they might enjoy. Data from Radio Browser.", "operationId": "entertainment_radio_top", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Top Radio Stations", "tags": [ "entertainment", "global", "music", "realtime", "radio-browser", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/radio/top", "x-examples": {} } }, "/api/v1/economics/indicators": { "get": { "description": "List all 15 available economic indicators with their keys and World Bank API codes. Indicators include GDP, GDP per capita, inflation (CPI), unemployment rate, purchasing power parity (PPP), trade balance, government debt, population, life expectancy, and more. Use this endpoint to discover which indicators are available before querying country-specific data. Data sourced from the World Bank Open Data platform.", "operationId": "finance_economics_indicators", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Available Indicators", "tags": [ "finance", "global", "reference", "lookup", "world-bank", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/economics/indicators", "x-examples": {} } }, "/api/v1/books/search": { "get": { "description": "Search for books by title, author, or keyword across the Open Library catalog of millions of published works. Returns book titles, author names, publication years, cover image IDs, ISBNs, and subject categories. Useful for building reading list apps, book recommendation engines, library catalog interfaces, and literary exploration tools.", "operationId": "food_books_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Book Search", "tags": [ "food", "global", "reference", "search", "open-library", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/books/search?q=elixir+programming\"", "x-examples": { "Search for Elixir programming books": "curl \"https://nordapi.ee/api/v1/books/search?q=elixir+programming\"", "Search for books by Tolkien": "curl \"https://nordapi.ee/api/v1/books/search?q=tolkien+lord+rings\"", "Search for science fiction books": "curl \"https://nordapi.ee/api/v1/books/search?q=science+fiction\"" } } }, "/api/v1/poetry/random": { "get": { "description": "Get a random poem from the PoetryDB collection of classic English poetry. Returns the poem's title, author, full text (as lines), and line count. Features works by Shakespeare, Dickinson, Keats, Poe, Whitman, and more.", "operationId": "language_poetry_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Poem", "tags": [ "language", "global", "poetry", "lookup", "poetrydb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/poetry/random", "x-examples": {} } }, "/api/v1/pollen/current": { "get": { "description": "Latest hourly pollen readings from all 16 MeteoSwiss stations. Reports concentrations in particles/m³ for 7 pollen types: alder, birch, hazel, beech, ash, oak, and grasses. Real sensor measurements updated daily — not modeled estimates like Google or Ambee. Essential for allergy apps, outdoor activity planners, and health monitoring systems.", "operationId": "geo_pollen_current", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Current Pollen Levels", "tags": [ "geo", "switzerland", "europe", "environment", "health", "realtime", "pollen-meteoswiss", "cc-by", "none" ], "x-example": "curl https://nordapi.ee/api/v1/pollen/current", "x-examples": {} } }, "/api/v1/recipes/areas": { "get": { "description": "List all available cuisine regions/origins (e.g., Italian, Japanese, Mexican, Indian, French, Thai, etc.). Use these to build cuisine-based recipe filters and explore food from different cultures. Data from TheMealDB covering 25+ world cuisines.", "operationId": "entertainment_recipes_areas", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cuisine Regions", "tags": [ "entertainment", "global", "food", "lookup", "themealdb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/recipes/areas", "x-examples": {} } }, "/api/v1/riigikogu/votings": { "get": { "description": "Get parliamentary voting records from the Estonian Parliament (Riigikogu) for a date range. Returns each vote with its description, type, attendance, and vote counts (in favor, against, neutral, abstained).", "operationId": "estonia_riigikogu_votings", "parameters": [ { "description": "Start date (YYYY-MM-DD)", "in": "query", "name": "start_date", "required": true, "schema": { "type": "string" } }, { "description": "End date (YYYY-MM-DD)", "in": "query", "name": "end_date", "required": true, "schema": { "type": "string" } }, { "description": "Language: en or et", "in": "query", "name": "lang", "required": false, "schema": { "default": "en", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Riigikogu Votings by Date Range", "tags": [ "estonia", "baltic", "civic", "legal", "search", "riigikogu", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/riigikogu/votings?start_date=2026-03-01&end_date=2026-03-30\"", "x-examples": {} } }, "/api/v1/names/gender/{name}": { "get": { "description": "Predict the likely gender associated with a first name using statistical data from millions of records across many countries. Returns the predicted gender and a probability score (0 to 1). Useful for personalizing user interfaces before explicit gender is provided, marketing analytics, form pre-filling, and demographic research. Data from Genderize.io.", "operationId": "world_names_gender", "parameters": [ { "description": "First name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Predict Gender from Name", "tags": [ "world", "global", "reference", "statistics", "lookup", "genderize", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/names/gender/alex", "x-examples": { "Predict gender for Alex": "curl https://nordapi.ee/api/v1/names/gender/alex", "Predict gender for Maria": "curl https://nordapi.ee/api/v1/names/gender/maria", "Predict gender for Robin": "curl https://nordapi.ee/api/v1/names/gender/robin" } } }, "/api/v1/mashup/brewery/trip": { "get": { "description": "Plan a craft brewery tour: combines local breweries, weather forecast, and location data for any city.", "operationId": "mashups_brewery_trip", "parameters": [ { "description": "City name", "in": "path", "name": "city", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Brewery Trip Planner", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/brewery/trip?city=Oslo\"", "x-examples": {} } }, "/api/v1/economics/{country}/{indicator}": { "get": { "description": "Get a single economic indicator for a specific country with multiple years of historical data. Provide the country code and indicator key (e.g., gdp, inflation, gdp_per_capita, unemployment, ppp) in the URL. Returns year-by-year values for trend analysis. More focused than the full country endpoint when you only need one metric, useful for time-series charts and targeted economic comparisons.", "operationId": "finance_economics_indicator", "parameters": [ { "description": "Country code", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } }, { "description": "Indicator key (e.g. gdp, inflation, gdp_per_capita)", "in": "query", "name": "indicator", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Specific Indicator", "tags": [ "finance", "global", "reference", "lookup", "world-bank", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/economics/US/gdp_per_capita", "x-examples": { "Germany unemployment rate": "curl https://nordapi.ee/api/v1/economics/DE/unemployment", "Norway inflation rate": "curl https://nordapi.ee/api/v1/economics/NO/inflation", "US GDP per capita over time": "curl https://nordapi.ee/api/v1/economics/US/gdp_per_capita" } } }, "/api/v1/sports/{sport}/{league}": { "get": { "description": "Get live and recent scores for a specific sport and league. Returns match details including team names, current scores, game status (scheduled/in-progress/final), and timing. Provide the sport and league codes from the available sports endpoint (e.g., soccer/eng.1 for the English Premier League). Useful for sports dashboards, score tickers, betting apps, and fantasy sports tools. Data from ESPN.", "operationId": "entertainment_sports_scores", "parameters": [ { "description": "Sport", "in": "query", "name": "sport", "required": true, "schema": { "type": "string" } }, { "description": "League", "in": "query", "name": "league", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Live Scores", "tags": [ "entertainment", "global", "sports", "realtime", "espn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/sports/soccer/eng.1", "x-examples": { "English Premier League scores": "curl https://nordapi.ee/api/v1/sports/soccer/eng.1", "NBA basketball scores": "curl https://nordapi.ee/api/v1/sports/basketball/nba", "NFL football scores": "curl https://nordapi.ee/api/v1/sports/football/nfl" } } }, "/api/v1/tallinn/districts": { "get": { "description": "All 8 Tallinn city districts (linnaosad) with population and area. Includes Haabersti, Kesklinn, Kristiine, Lasnamäe, Mustamäe, Nõmme, Pirita, and Põhja-Tallinn.", "operationId": "estonia_tallinn_districts", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Districts", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-info", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/districts", "x-examples": {} } }, "/api/v1/dns/reverse": { "get": { "description": "Perform a reverse DNS (PTR) lookup to find the hostname associated with an IP address. Takes an IP address and returns its registered hostname. Useful for identifying servers by IP, verifying email sender authenticity, security investigations, and network administration tasks where you need to resolve IPs back to domain names.", "operationId": "tools_dns_reverse", "parameters": [ { "description": "IP address", "in": "query", "name": "ip", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Reverse DNS", "tags": [ "tools", "global", "dns", "lookup", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/dns/reverse?ip=8.8.8.8\"", "x-examples": { "Reverse DNS for Cloudflare": "curl \"https://nordapi.ee/api/v1/dns/reverse?ip=1.1.1.1\"", "Reverse DNS for Google DNS": "curl \"https://nordapi.ee/api/v1/dns/reverse?ip=8.8.8.8\"" } } }, "/api/v1/holidays/check": { "get": { "description": "Check whether a specific date is a public holiday in a given country. Returns holiday name and details if the date is a holiday, or confirms it is not. Supports 100+ countries. Ideal for payroll systems that need to account for public holidays, scheduling apps that should block holiday dates, and business tools that adjust deadlines around non-working days.", "operationId": "world_holidays_check", "parameters": [ { "description": "Country code", "in": "query", "name": "country", "required": true, "schema": { "type": "string" } }, { "description": "Date", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Check Holiday", "tags": [ "world", "global", "reference", "time", "lookup", "nager-date", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/holidays/check?country=US&date=2026-12-25\"", "x-examples": { "Check Norwegian Constitution Day": "curl \"https://nordapi.ee/api/v1/holidays/check?country=NO&date=2026-05-17\"", "Check a regular weekday in Germany": "curl \"https://nordapi.ee/api/v1/holidays/check?country=DE&date=2026-03-25\"", "Check if Christmas is a US holiday": "curl \"https://nordapi.ee/api/v1/holidays/check?country=US&date=2026-12-25\"" } } }, "/api/v1/fun/date/{month}/{day}": { "get": { "description": "Get a historical fact about a specific date (month and day). Returns an interesting event that happened on that date in history, such as 'March 24 is the day that the Exxon Valdez oil spill occurred in 1989.' Useful for daily historical trivia features, birthday fun facts, educational calendar apps, and 'on this day' widgets. Data from the Numbers API.", "operationId": "entertainment_fun_date", "parameters": [ { "description": "Month", "in": "path", "name": "month", "required": true, "schema": { "type": "string" } }, { "description": "Day", "in": "path", "name": "day", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Date Fact", "tags": [ "entertainment", "global", "reference", "lookup", "numbersapi", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/fun/date/3/24", "x-examples": { "Historical fact about December 25": "curl https://nordapi.ee/api/v1/fun/date/12/25", "Historical fact about March 24": "curl https://nordapi.ee/api/v1/fun/date/3/24", "What happened on January 1": "curl https://nordapi.ee/api/v1/fun/date/1/1" } } }, "/api/v1/estonian-utilities/{type}": { "get": { "description": "Get rates for a specific utility type: water, heating, electricity, gas, or waste.", "operationId": "estonia_ee_utility_type", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Estonian Utility by Type", "tags": [ "estonia", "baltic", "power", "lookup", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/estonian-utilities/electricity", "x-examples": {} } }, "/api/v1/mashup/travel/cost": { "get": { "description": "Calculate a comprehensive travel cost estimate between two countries, combining currency exchange rates, purchasing power parity (PPP) adjustment, destination weather forecast, and upcoming holidays at the destination. Converts your budget into local currency and adjusts it for local purchasing power so you know what your money is actually worth. Perfect for travel planning apps, budget calculators, and trip comparison tools.", "operationId": "mashups_travel_cost", "parameters": [ { "description": "Origin country", "in": "query", "name": "from", "required": true, "schema": { "type": "string" } }, { "description": "Destination", "in": "query", "name": "to", "required": true, "schema": { "type": "string" } }, { "description": "Budget", "in": "query", "name": "budget", "required": false, "schema": { "default": "1000", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Travel Cost Calculator", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/travel/cost?from=US&to=JP&budget=5000\"", "x-examples": { "Norway to Thailand on a budget": "curl \"https://nordapi.ee/api/v1/mashup/travel/cost?from=NO&to=TH&budget=2000\"", "UK to Spain with default budget": "curl \"https://nordapi.ee/api/v1/mashup/travel/cost?from=GB&to=ES\"", "US to Japan travel cost with $5000 budget": "curl \"https://nordapi.ee/api/v1/mashup/travel/cost?from=US&to=JP&budget=5000\"" } } }, "/api/v1/carbon/calculate": { "get": { "description": "Calculate the CO2 emissions (in kg) for a specific activity and amount. Supports activities like flights, driving, electricity usage, and heating. Provide the activity type and amount (e.g., kilometers driven, kWh consumed). Returns the total CO2 equivalent. Useful for personal carbon footprint trackers, corporate sustainability reporting tools, and environmental awareness apps that help users understand their impact.", "operationId": "science_carbon_calculate", "parameters": [ { "description": "Activity type", "in": "query", "name": "activity", "required": true, "schema": { "type": "string" } }, { "description": "Amount", "in": "query", "name": "amount", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Carbon Calculator", "tags": [ "science", "global", "environment", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/carbon/calculate?activity=flight_long&amount=5000\"", "x-examples": { "CO2 from 500 kWh electricity": "curl \"https://nordapi.ee/api/v1/carbon/calculate?activity=electricity&amount=500\"", "CO2 from a long-haul flight (5000 km)": "curl \"https://nordapi.ee/api/v1/carbon/calculate?activity=flight_long&amount=5000\"", "CO2 from driving 100 km": "curl \"https://nordapi.ee/api/v1/carbon/calculate?activity=driving&amount=100\"" } } }, "/api/v1/qr/generate": { "get": { "description": "Generate a QR code image URL for any text, URL, or data string. Configurable size (default 300px). Returns a URL to a PNG QR code image that can be embedded in web pages, printed on materials, or displayed in apps. Useful for sharing URLs, Wi-Fi credentials, contact cards, event tickets, payment links, and any data that needs to be quickly scannable by mobile devices.", "operationId": "tools_qr_generate", "parameters": [ { "description": "Data to encode", "in": "query", "name": "data", "required": true, "schema": { "type": "string" } }, { "description": "Size", "in": "query", "name": "size", "required": false, "schema": { "default": "300", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "QR Code Generator", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/qr/generate?data=https://nordapi.ee\"", "x-examples": { "Large QR code for a URL": "curl \"https://nordapi.ee/api/v1/qr/generate?data=https://nordapi.ee&size=500\"", "QR code for a URL": "curl \"https://nordapi.ee/api/v1/qr/generate?data=https://nordapi.ee\"", "QR code for plain text": "curl \"https://nordapi.ee/api/v1/qr/generate?data=Hello+World&size=200\"" } } }, "/api/v1/spaceweather/kp/history": { "get": { "description": "Full time series of planetary Kp index readings collected continuously from NOAA SWPC. Filter with ?start and ?end. Valuable for aurora forecasters correlating past activity with sightings, space weather researchers studying storm distributions, and dashboards plotting geomagnetic trends over months or years.", "operationId": "science_spaceweather_kp_history", "parameters": [ { "description": "Start datetime", "in": "query", "name": "start", "required": false, "schema": { "type": "string" } }, { "description": "End datetime", "in": "query", "name": "end", "required": false, "schema": { "type": "string" } }, { "description": "Max rows (cap 10000)", "in": "path", "name": "limit", "required": true, "schema": { "default": "500", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Kp Index History", "tags": [ "science", "global", "geomagnetic", "space", "snapshot-history", "noaa-swpc", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/spaceweather/kp/history?limit=500\"", "x-examples": {} } }, "/api/v1/mashup/portfolio/analyze": { "get": { "description": "Analyze a portfolio of mixed assets (cryptocurrencies, fiat currencies, and commodities) in a single request. Provide a comma-separated list of asset identifiers and get back current values, performance metrics, correlation data, and diversification analysis. Supports crypto coin IDs (bitcoin, ethereum), fiat currency codes (EUR, NOK), and gold. Ideal for portfolio tracking dashboards, investment analysis tools, and wealth management platforms that span multiple asset classes.", "operationId": "mashups_portfolio", "parameters": [ { "description": "Comma-separated asset IDs (e.g., bitcoin,ethereum,EUR,gold)", "in": "query", "name": "assets", "required": true, "schema": { "type": "string" } }, { "description": "Base currency for valuation", "in": "query", "name": "base", "required": false, "schema": { "default": "USD", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Portfolio Analyzer", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/portfolio/analyze?assets=bitcoin,ethereum,EUR,gold\"", "x-examples": { "Analyze Nordic currency basket": "curl \"https://nordapi.ee/api/v1/mashup/portfolio/analyze?assets=NOK,SEK,DKK&base=USD\"", "Analyze a mixed crypto and fiat portfolio": "curl \"https://nordapi.ee/api/v1/mashup/portfolio/analyze?assets=bitcoin,ethereum,EUR,gold\"", "Analyze crypto portfolio in EUR": "curl \"https://nordapi.ee/api/v1/mashup/portfolio/analyze?assets=bitcoin,ethereum,solana&base=EUR\"" } } }, "/api/v1/mashup/commodity/currency": { "get": { "description": "Analyze how commodity prices relate to currency movements: combines commodity spot prices with forex rates and 30-day volatility for multiple currencies.", "operationId": "mashups_commodity_currency", "parameters": [ { "description": "Commodity name (default gold)", "in": "query", "name": "commodity", "required": false, "schema": { "type": "string" } }, { "description": "Comma-separated currency codes (default USD,EUR,GBP,NOK)", "in": "query", "name": "currencies", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Commodity-Currency Correlation", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/commodity/currency?commodity=gold¤cies=USD,EUR,NOK\"", "x-examples": {} } }, "/api/v1/elering/prices": { "get": { "description": "Nord Pool spot electricity prices for Estonia (EE), Finland (FI), Latvia (LV), and Lithuania (LT). Returns hourly prices in EUR/MWh for the specified date range.", "operationId": "estonia_elering_prices", "parameters": [ { "description": "Start date (YYYY-MM-DD)", "in": "query", "name": "start", "required": true, "schema": { "type": "string" } }, { "description": "End date (YYYY-MM-DD)", "in": "query", "name": "end", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Baltic Electricity Prices", "tags": [ "estonia", "baltic", "power", "lookup", "elering", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/elering/prices?start=2026-03-29&end=2026-03-30\"", "x-examples": {} } }, "/api/v1/time/convert": { "get": { "description": "Convert a datetime from one timezone to another.", "operationId": "time_time_convert", "parameters": [ { "description": "Source timezone (e.g. Europe/Oslo)", "in": "query", "name": "from", "required": true, "schema": { "type": "string" } }, { "description": "Target timezone (e.g. America/New_York)", "in": "query", "name": "to", "required": true, "schema": { "type": "string" } }, { "description": "DateTime to convert (e.g. 2026-03-30 12:00:00)", "in": "query", "name": "datetime", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Convert Between Timezones", "tags": [ "time", "global", "timezone", "computed", "timeapi", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/time/convert?from=Europe/Oslo&to=America/New_York&datetime=2026-03-30+12:00:00\"", "x-examples": {} } }, "/api/v1/elevation/lookup": { "get": { "description": "Get the elevation (meters above sea level) for any coordinates on Earth using SRTM 90m satellite data. Resolution is approximately 90 meters.", "operationId": "geography_elevation_lookup", "parameters": [ { "description": "Latitude (-90 to 90)", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude (-180 to 180)", "in": "query", "name": "lng", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Elevation Lookup", "tags": [ "geography", "global", "lookup", "open-topo-data", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/elevation/lookup?lat=59.9139&lng=10.7522\"", "x-examples": {} } }, "/api/v1/tallinn/services": { "get": { "description": "City government contacts, public transport info (free for residents since 2013), waste management centers, parking zones, and library system.", "operationId": "estonia_tallinn_services", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Public Services", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-info", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/services", "x-examples": {} } }, "/api/v1/metals/historical/{metal}/{date}": { "get": { "description": "Look up the price of a specific precious metal (gold, silver, platinum, or palladium) on any past date. Provide the metal name and date in the URL path. Returns the USD price for that date. Useful for historical portfolio valuation, insurance appraisals, academic research on metal price trends, and comparing metal performance against other assets over time.", "operationId": "finance_metals_historical", "parameters": [ { "description": "Metal name (gold, silver, platinum, palladium)", "in": "query", "name": "metal", "required": true, "schema": { "type": "string" } }, { "description": "Date (YYYY-MM-DD)", "in": "path", "name": "date", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Historical Metal Price", "tags": [ "finance", "global", "commodities", "snapshot-history", "frankfurter", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/metals/historical/gold/2026-03-20", "x-examples": { "Gold price on a specific date": "curl https://nordapi.ee/api/v1/metals/historical/gold/2026-03-20", "Platinum price last month": "curl https://nordapi.ee/api/v1/metals/historical/platinum/2026-02-15", "Silver price at start of year": "curl https://nordapi.ee/api/v1/metals/historical/silver/2026-01-02" } } }, "/api/v1/mashup/country/{code}": { "get": { "description": "Get a comprehensive intelligence report for any country, combining data from multiple NordAPI sources into a single response. Includes economic indicators (GDP, inflation, unemployment), current weather in the capital, upcoming public holidays, health statistics, currency information, and geographic data. Saves you from making 6+ separate API calls. Ideal for country profile pages, travel research tools, and market entry analysis dashboards.", "operationId": "mashups_country_intel", "parameters": [ { "description": "Country code", "in": "path", "name": "code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Country Intelligence", "tags": [ "mashups" ], "x-example": "curl https://nordapi.ee/api/v1/mashup/country/NO", "x-examples": { "Brazil country intelligence": "curl https://nordapi.ee/api/v1/mashup/country/BR", "Japan country intelligence": "curl https://nordapi.ee/api/v1/mashup/country/JP", "Norway country intelligence": "curl https://nordapi.ee/api/v1/mashup/country/NO" } } }, "/api/v1/trivia/categories": { "get": { "description": "List all available trivia question categories (e.g., Science, History, Geography, Entertainment, Sports, Art, etc.). Use these category IDs when requesting questions to get topic-specific trivia. Useful for building category selection screens in quiz apps and ensuring questions match your audience's interests.", "operationId": "entertainment_trivia_categories", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Trivia Categories", "tags": [ "entertainment", "global", "games", "reference", "lookup", "open-trivia", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/trivia/categories", "x-examples": {} } }, "/api/v1/latest": { "get": { "description": "Get today's exchange rates for any of the 30 supported base currencies against all other currencies or a filtered subset. Returns the rate date and a map of currency-to-rate pairs. Rates are updated daily from the European Central Bank (ECB). Ideal for currency converters, financial dashboards, pricing pages, and any app that needs current FX rates.", "operationId": "finance_latest", "parameters": [ { "description": "Base currency code", "in": "query", "name": "base", "required": false, "schema": { "default": "EUR", "type": "string" } }, { "description": "Comma-separated target currencies", "in": "query", "name": "symbols", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Latest Exchange Rates", "tags": [ "finance", "global", "realtime", "frankfurter", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/latest?base=USD&symbols=EUR,GBP,NOK\"", "x-examples": { "All rates with EUR base (default)": "curl \"https://nordapi.ee/api/v1/latest\"", "GBP base against major currencies": "curl \"https://nordapi.ee/api/v1/latest?base=GBP&symbols=USD,EUR,JPY,CHF\"", "USD base with Nordic currencies": "curl \"https://nordapi.ee/api/v1/latest?base=USD&symbols=NOK,SEK,DKK\"" } } }, "/api/v1/mashup/energy/weather": { "get": { "description": "Analyze the relationship between weather conditions and electricity prices for a specific Nordic bidding zone. Combines real-time electricity spot prices from Nord Pool with current weather data (temperature, wind, cloud cover) to show how weather patterns affect energy costs. Returns price data alongside weather metrics and correlation insights. Essential for energy trading dashboards, smart home optimization, and utility companies analyzing price drivers.", "operationId": "mashups_energy_weather", "parameters": [ { "description": "Nordic bidding zone (NO1-NO5, SE1-SE4)", "in": "path", "name": "zone", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Energy-Weather Correlation", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/energy/weather?zone=NO1\"", "x-examples": { "Energy-weather correlation for Oslo area (NO1)": "curl \"https://nordapi.ee/api/v1/mashup/energy/weather?zone=NO1\"", "Energy-weather for Northern Norway (NO4)": "curl \"https://nordapi.ee/api/v1/mashup/energy/weather?zone=NO4\"", "Energy-weather for Stockholm area (SE3)": "curl \"https://nordapi.ee/api/v1/mashup/energy/weather?zone=SE3\"" } } }, "/api/v1/cocktails/search": { "get": { "description": "Search for cocktail recipes by name (e.g., margarita, mojito, old fashioned). Returns matching cocktails with names, images, ingredients with measurements, mixing instructions, glass type, and whether the drink is alcoholic. Data from TheCocktailDB. Useful for bartending apps, drink recipe sites, restaurant menu builders, and party planning tools.", "operationId": "entertainment_cocktails_search", "parameters": [ { "description": "Query", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Cocktail Search", "tags": [ "entertainment", "global", "drinks", "food", "search", "cocktaildb", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/cocktails/search?q=margarita\"", "x-examples": { "Search for margarita recipes": "curl \"https://nordapi.ee/api/v1/cocktails/search?q=margarita\"", "Search for mojito recipes": "curl \"https://nordapi.ee/api/v1/cocktails/search?q=mojito\"", "Search for old fashioned": "curl \"https://nordapi.ee/api/v1/cocktails/search?q=old+fashioned\"" } } }, "/api/v1/generate/color": { "get": { "description": "Generate a random color with its hex code, RGB values, HSL values, and a human-readable color name. Useful for design tools that need color inspiration, generative art projects, UI theming features, placeholder color generation, and any creative application that benefits from random color selection.", "operationId": "tools_generate_color", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random Color", "tags": [ "tools", "global", "generators", "computed", "internal", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/generate/color", "x-examples": {} } }, "/api/v1/xkcd/random": { "get": { "description": "Get a random xkcd comic from the entire archive of 2,900+ comics spanning nearly two decades. Returns the comic title, number, image URL, alt text (the hidden hover text), and publication date. Perfect for 'surprise me' features, random content feeds, break-time entertainment widgets, and boredom-busting app features.", "operationId": "entertainment_xkcd_random", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Random xkcd Comic", "tags": [ "entertainment", "global", "computed", "xkcd", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/xkcd/random", "x-examples": {} } }, "/api/v1/link/preview": { "get": { "description": "Extract metadata from any URL: title, description, author, publisher, language, images, and logos. Perfect for building link preview cards like those in Slack, Twitter, or Discord.", "operationId": "texttools_link_preview", "parameters": [ { "description": "URL to extract metadata from", "in": "query", "name": "url", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "URL Link Preview", "tags": [ "texttools", "global", "tools", "text", "lookup", "microlink", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/link/preview?url=https://github.com\"", "x-examples": {} } }, "/api/v1/tv/{id}": { "get": { "description": "Get comprehensive details for a specific TV show by its TVMaze ID, including full cast list, episode guide, genres, rating, network, schedule, premiere date, and plot summary. Useful for building show detail pages, cast browsing features, and episode tracking functionality in entertainment apps.", "operationId": "entertainment_tv_show", "parameters": [ { "description": "Show ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "TV Show Detail", "tags": [ "entertainment", "global", "tv", "lookup", "tvmaze", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tv/1", "x-examples": { "Game of Thrones (show ID 82)": "curl https://nordapi.ee/api/v1/tv/82", "The Office (show ID 526)": "curl https://nordapi.ee/api/v1/tv/526", "Under the Dome (show ID 1)": "curl https://nordapi.ee/api/v1/tv/1" } } }, "/api/v1/mashup/stargazing": { "get": { "description": "Evaluate any location for stargazing: combines Bortle-class light pollution data, cloud cover forecast, elevation, and sunset time into a viewing quality assessment with practical tips.", "operationId": "mashups_stargazing", "parameters": [ { "description": "Latitude", "in": "query", "name": "lat", "required": true, "schema": { "type": "string" } }, { "description": "Longitude", "in": "query", "name": "lon", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Stargazing Spot Finder", "tags": [ "mashups" ], "x-example": "curl \"https://nordapi.ee/api/v1/mashup/stargazing?lat=58.5&lon=25.0\"", "x-examples": {} } }, "/api/v1/xkcd/latest": { "get": { "description": "Get the most recent xkcd webcomic with its title, number, image URL, alt text, and publication date. xkcd is a beloved webcomic by Randall Munroe covering science, technology, math, and language with a distinctive stick-figure art style. Updated three times per week. Useful for developer dashboards, geek culture feeds, daily comic widgets, and educational content platforms.", "operationId": "entertainment_xkcd_latest", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Latest xkcd Comic", "tags": [ "entertainment", "global", "scheduled", "xkcd", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/xkcd/latest", "x-examples": {} } }, "/api/v1/anime/top": { "get": { "description": "Get the highest-rated anime or manga of all time, ranked by MyAnimeList community scores. Returns titles, scores, episode counts, synopses, and cover images. Switch between anime and manga rankings with the type parameter. Useful for recommendation features, 'best of all time' lists, and helping newcomers discover critically acclaimed series. Data from Jikan/MyAnimeList.", "operationId": "entertainment_anime_top", "parameters": [ { "description": "anime or manga", "in": "path", "name": "type", "required": true, "schema": { "default": "anime", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Top Anime", "tags": [ "entertainment", "global", "anime", "lookup", "jikan", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/anime/top", "x-examples": { "Top rated anime of all time": "curl https://nordapi.ee/api/v1/anime/top", "Top rated manga of all time": "curl \"https://nordapi.ee/api/v1/anime/top?type=manga\"" } } }, "/api/v1/poetry/search": { "get": { "description": "Search for poems containing specific words or phrases in their text.", "operationId": "language_poetry_search", "parameters": [ { "description": "Text to search for in poem lines", "in": "query", "name": "q", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Search Poetry by Lines", "tags": [ "language", "global", "poetry", "search", "poetrydb", "open", "none" ], "x-example": "curl \"https://nordapi.ee/api/v1/poetry/search?q=shall+I+compare\"", "x-examples": {} } }, "/api/v1/tallinn/life": { "get": { "description": "Complete guide to living in and visiting Tallinn: museums with free Sunday dates, parking zones and rates, free activities, and seasonal events. Everything in one response.", "operationId": "estonia_tallinn_life", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn Living Guide", "tags": [ "estonia", "baltic", "civic", "lookup", "tallinn-life", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/life", "x-examples": {} } }, "/api/v1/tallinn/data/budget": { "get": { "description": "Tallinn city budget data including revenue and expenditure.", "operationId": "estonia_tallinn_budget", "parameters": [ { "description": "Results per page", "in": "query", "name": "per_page", "required": false, "schema": { "default": "100", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "Tallinn City Budget", "tags": [ "estonia", "baltic", "civic", "finance", "lookup", "avaandmed-tallinn", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/tallinn/data/budget", "x-examples": {} } }, "/api/v1/cocktails/ingredient/{ingredient}": { "get": { "description": "Find all cocktails that use a specific ingredient (e.g., vodka, rum, lime juice). Returns matching cocktail names and thumbnails. Useful for building 'cocktails you can make' features based on available ingredients, ingredient-focused recipe discovery, and bartending apps that organize drinks by spirit type. Data from TheCocktailDB.", "operationId": "entertainment_cocktails_ingredient", "parameters": [ { "description": "Ingredient", "in": "query", "name": "ingredient", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": {}, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "description": "Bad request (missing/invalid parameters)" }, "404": { "description": "Resource not found" }, "429": { "description": "Rate limit exceeded" }, "502": { "description": "Upstream service unavailable" } }, "summary": "By Ingredient", "tags": [ "entertainment", "global", "drinks", "food", "lookup", "cocktaildb", "open", "none" ], "x-example": "curl https://nordapi.ee/api/v1/cocktails/ingredient/vodka", "x-examples": { "Cocktails with rum": "curl https://nordapi.ee/api/v1/cocktails/ingredient/rum", "Cocktails with tequila": "curl https://nordapi.ee/api/v1/cocktails/ingredient/tequila", "Cocktails with vodka": "curl https://nordapi.ee/api/v1/cocktails/ingredient/vodka" } } } }, "openapi": "3.1.0", "servers": [ { "description": "Production", "url": "https://nordapi.ee" } ] }