{"openapi":"3.1.0","info":{"title":"National Dishes API","version":"1.0.0","description":"The dish most associated with each country as an API — a small, fun reference for travel, food, quiz and trivia apps. Built on the open country-json national-dish dataset and enriched with each country's ISO 3166-1 alpha-2 code and Unicode flag emoji. Look up a country's national dish by country name or code, search dishes and countries by keyword (for example, find every country whose national dish involves rice), or list them all. Served from memory — always fast.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nationaldishes-api","description":"oanor gateway"}],"tags":[{"name":"Lookup"},{"name":"Search"},{"name":"List"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/dish":{"get":{"operationId":"get_v1_dish","tags":["Lookup"],"summary":"National dish by country or code","description":"","parameters":[{"name":"country","in":"query","required":false,"description":"Country name","schema":{"type":"string"},"example":"Italy"},{"name":"code","in":"query","required":false,"description":"ISO 3166-1 alpha-2 code","schema":{"type":"string"},"example":"it"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"national_dish":{"code":"IT","dish":"Pasta,Polenta,Pizza, Risotto","emoji":"🇮🇹","country":"Italy"}},"meta":{"timestamp":"2026-06-08T18:25:08.991Z","request_id":"2d608af9-c632-40d6-832d-9715c36282d0"},"status":"ok","message":"National dish retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search dishes and countries","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query (min 2 chars)","schema":{"type":"string"},"example":"rice"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":7,"query":"rice","total":7,"dishes":[{"code":"BS","dish":"Crack conch with peas and rice","emoji":"🇧🇸","country":"Bahamas"},{"code":"BD","dish":"Rice, Fish, Chicken Korma","emoji":"🇧🇩","country":"Bangladesh"},{"code":"DO","dish":"rice, red beans, and meat","emoji":"🇩🇴","country":"Dominican Republic"},{"code":"HT","dish":"Red beans and rice","emoji":"🇭🇹","country":"Haiti"},{"code":"NG","dish":"Jollof rice","emoji":"🇳🇬","country":"Nigeria"},{"code":"SG","dish":"Chilli crab,Hainanese Chicken Rice","emoji":"🇸🇬","country":"Singapore"},{"code":"LK","dish":"Rice and curry, pittu, kiribath, wholemeal roti, string hoppers, wattalapam, kottu, and appam","emoji":"🇱🇰","country":"Sri Lanka"}]},"meta":{"timestamp":"2026-06-08T18:25:09.117Z","request_id":"44889a80-e0f5-422c-b683-4b841c145a7e"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["List"],"summary":"List national dishes","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-300)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"},{"name":"with_dish","in":"query","required":false,"description":"Only countries that have a dish","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"total":145,"dishes":[{"code":"AF","dish":"Kabuli Palaw","emoji":"🇦🇫","country":"Afghanistan"},{"code":"AL","dish":"Tavë kosi","emoji":"🇦🇱","country":"Albania"},{"code":"DZ","dish":"Couscous","emoji":"🇩🇿","country":"Algeria"},{"code":"AO","dish":"Moamba de galinha","emoji":"🇦🇴","country":"Angola"},{"code":"AG","dish":"Pepperpot, Fungee","emoji":"🇦🇬","country":"Antigua and Barbuda"},{"code":"AR","dish":"Asado","emoji":"🇦🇷","country":"Argentina"},{"code":"AM","dish":"Harissa, Dolma, Khorovats","emoji":"🇦🇲","country":"Armenia"},{"code":"AW","dish":"Keshi yena","emoji":"🇦🇼","country":"Aruba"},{"code":"AU","dish":"Meat pie,Roast lamb","emoji":"🇦🇺","country":"Australia"},{"code":"AT","dish":"Wiener schnitzel, Tafelspitz","emoji":"🇦🇹","country":"Austria"},{"code":"AZ","dish":"Dolma","emoji":"🇦🇿","country":"Azerbaijan"},{"code":"BS","dish":"Crack conch with peas and rice","emoji":"🇧🇸","country":"Bahamas"},{"code":"BH","dish":"Machboos","emoji":"🇧🇭","country":"Bahrain"},{"code":"BD","dish":"Rice, Fish, Chicken Korma","emoji":"🇧🇩","country":"Bangladesh"},{"code":"BB","dish":"Cou-Cou and Flying Fish","emoji":"🇧🇧","country":"Barbados"},{"code":"BY","dish":"Draniki","emoji":"🇧🇾","country":"Belarus"},{"code":"BE","dish":"Moules-frites","emoji":"🇧🇪","country":"Belgium"},{"code":"BZ","dish":"Boil up","emoji":"🇧🇿","country":"Belize"},{"code":"BM","dish":"Bermuda fish chowder","emoji":"🇧🇲","country":"Bermuda"},{"code":"BT","dish":"Ema datshi","emoji":"🇧🇹","country":"Bhutan"},{"code":"BO","dish":"Salteñas","emoji":"🇧🇴","country":"Bolivia"},{"code":"BA","dish":"Bosnian pot","emoji":"🇧🇦","country":"Bosnia and Herzegovina"},{"code":"BW","dish":"Seswaa","emoji":"🇧🇼","country":"Botswana"},{"code":"BR","dish":"Feijoada","emoji":"🇧🇷","country":"Brazil"},{"code":"BN","dish":"Ambuyat","emoji":"🇧🇳","country":"Brunei"},{"code":"BG","dish":"Banitsa, Bob chorba","emoji":"🇧🇬","country":"Bulgaria"},{"code":"KH","dish":"Amok trey","emoji":"🇰🇭","country":"Cambodia"},{"code":"CM","dish":"Ndolé","emoji":"🇨🇲","country":"Cameroon"},{"code":"CA","dish":"Kraft Dinner","emoji":"🇨🇦","country":"Canada"},{"code":"CV","dish":"Cachupa","emoji":"🇨🇻","country":"Cape Verde"},{"code":"CL","dish":"Empanada","emoji":"🇨🇱","country":"Chile"},{"code":"CN","dish":"Peking Duck","emoji":"🇨🇳","country":"China"},{"code":"CO","dish":"Ajiaco, Bandeja paisa","emoji":"🇨🇴","country":"Colombia"},{"code":"CR","dish":"Gallo pinto","emoji":"🇨🇷","country":"Costa Rica"},{"code":"HR","dish":"Istrian stew","emoji":"🇭🇷","country":"Croatia"},{"code":"CU","dish":"Ropa vieja, Moros y cristianos","emoji":"🇨🇺","country":"Cuba"},{"code":"CY","dish":"Fasolada","emoji":"🇨🇾","country":"Cyprus"},{"code":"CZ","dish":"roast pork with dumplings and sauerkraut","emoji":"🇨🇿","country":"Czech Republic"},{"code":"DK","dish":"fried pork and potato-based dish","emoji":"🇩🇰","country":"Denmark"},{"code":"DM","dish":"Mountain chicken, Fish broth","emoji":"🇩🇲","country":"Dominica"},{"code":"DO","dish":"rice, red beans, and meat","emoji":"🇩🇴","country":"Dominican Republic"},{"code":"EC","dish":"Encebollado, Fritada,Guatitas,","emoji":"🇪🇨","country":"Ecuador"},{"code":"EG","dish":"Ful medames, kushari,","emoji":"🇪🇬","country":"Egypt"},{"code":"SV","dish":"Pupusa","emoji":"🇸🇻","country":"El Salvador"},{"dish":"Beef,(especially roast beef/corned beef),Pudding","country":"England"},{"code":"ER","dish":"Zigini with injera, Gored gored, raw meat","emoji":"🇪🇷","country":"Eritrea"},{"code":"EE","dish":"sauerkraut stew","emoji":"🇪🇪","country":"Estonia"},{"code":"ET","dish":"Wat with injera, Fit-fit","emoji":"🇪🇹","country":"Ethiopia"},{"code":"FI","dish":"Karjalanpaisti, Mämmi, Sautéed reindeer","emoji":"🇫🇮","country":"Finland"},{"code":"FR","dish":"Crêpe, Pot-au-feu, Macaron, Bisque","emoji":"🇫🇷","country":"France"}]},"meta":{"timestamp":"2026-06-08T18:25:09.234Z","request_id":"1c696e6a-8869-418b-9a54-6d6649997b88"},"status":"ok","message":"National dishes listed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"nationaldishes-api","endpoints":{"GET /v1/dish":"National dish by country (country=, e.g. Italy) or code (code=, e.g. it).","GET /v1/list":"List national dishes (limit, offset, with_dish=true to skip empties).","GET /v1/meta":"This document.","GET /v1/search":"Search dishes and countries by keyword (q=, e.g. rice)."},"with_dish":145,"description":"The national dish of each country (open country-json dataset) enriched with ISO 3166-1 alpha-2 code and flag emoji. Look up by country or code, search dishes by keyword, or list them. No key.","total_countries":243},"meta":{"timestamp":"2026-06-08T18:25:09.327Z","request_id":"b3c219dd-cd1e-4421-b4b8-06051aaea62d"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":300,"monthly_call_quota":120000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":900,"monthly_call_quota":600000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2200,"monthly_call_quota":3000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nationaldishes-api"}