{"openapi":"3.1.0","info":{"title":"Iconify Icons API","version":"1.0.0","description":"The open-source icon universe — Iconify — as an API. Search across 200,000+ icons from 200+ icon sets (Material Symbols, Material Design Icons, Font Awesome, Tabler, Lucide, Phosphor, Simple Icons, brand logos and more); get any icon's SVG path, dimensions and a ready-to-use, copy-paste `<svg>` string plus a direct .svg URL; and browse the icon sets with their author, license and icon count. Every icon is addressed by a simple `prefix:name` id (e.g. mdi:home, logos:github). Live from the official api.iconify.design. Ideal for design tools and icon pickers, no-code and website builders, documentation and component libraries, and any app that needs scalable icons. Open-source icons, each with its set's license.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/iconify-api","description":"oanor gateway"}],"tags":[{"name":"Iconify"},{"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/collections":{"get":{"operationId":"get_v1_collections","tags":["Iconify"],"summary":"Browse icon sets","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Filter sets by name/prefix/category","schema":{"type":"string"},"example":"material"},{"name":"limit","in":"query","required":false,"description":"Results (1-300)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":8,"query":"material","total":8,"collections":[{"name":"Material Symbols Light","total":15483,"author":"Google","prefix":"material-symbols-light","license":"Apache 2.0","palette":false,"samples":["downloading","privacy-tip","filter-drama-outline","assignment-ind","monitoring","desktop-access-disabled-outline-sharp"],"category":"Material"},{"name":"Material Symbols","total":15409,"author":"Google","prefix":"material-symbols","license":"Apache 2.0","palette":false,"samples":["downloading","privacy-tip","filter-drama-outline","assignment-ind","monitoring","desktop-access-disabled-outline-sharp"],"category":"Material"},{"name":"Google Material Icons","total":10955,"author":"Material Design Authors","prefix":"ic","license":"Apache 2.0","palette":false,"samples":["baseline-notifications-active","outline-person-outline","twotone-videocam-off","sharp-flash-on","baseline-volume-mute","twotone-battery-20"],"category":"Material"},{"name":"Material Design Icons","total":7447,"author":"Pictogrammers","prefix":"mdi","license":"Apache 2.0","palette":false,"samples":["account-check","bell-alert-outline","calendar-edit","skip-previous","home-variant","lock-open-outline"],"category":"Material"},{"name":"Material Line Icons","total":1218,"author":"Vjacheslav Trushkin","prefix":"line-md","license":"MIT","palette":false,"samples":["loading-twotone-loop","beer-alt-twotone-loop","image-twotone","account","cloud-alt-upload-twotone-loop","cog-loop"],"category":"Material"},{"name":"Material Icon Theme","total":899,"author":"Material Extensions","prefix":"material-icon-theme","license":"MIT","palette":true,"samples":["zip","email","folder-upload","stackblitz","tree","vscode"],"category":"Programming"},{"name":"Material Design Iconic Font","total":777,"author":"MDI Community","prefix":"zmdi","license":"Open Font License","palette":false,"samples":["alarm-snooze","cloud-off","library"]},{"name":"Material Design Light","total":284,"author":"Pictogrammers","prefix":"mdi-light","license":"Open Font License","palette":false,"samples":["cart","bell","login","skip-previous","home","lock-open"],"category":"Material"}]},"meta":{"timestamp":"2026-05-31T14:05:59.081Z","request_id":"a5d950e2-9a42-4057-bddc-7d223e827cbb"},"status":"ok","message":"Collections retrieved","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/icon":{"get":{"operationId":"get_v1_icon","tags":["Iconify"],"summary":"Icon SVG + metadata","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Icon id in prefix:name form, e.g. mdi:home","schema":{"type":"string"},"example":"mdi:home"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"icon":{"id":"mdi:home","svg":"<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\"><path fill=\"currentColor\" d=\"M10 20v-6h4v6h5v-8h3L12 3L2 12h3v8z\"/></svg>","body":"<path fill=\"currentColor\" d=\"M10 20v-6h4v6h5v-8h3L12 3L2 12h3v8z\"/>","name":"home","width":24,"height":24,"prefix":"mdi","css_url":"https://api.iconify.design/mdi.css?icons=home","svg_url":"https://api.iconify.design/mdi:home.svg","view_box":"0 0 24 24","iconify_url":"https://icon-sets.iconify.design/mdi/home/"}},"meta":{"timestamp":"2026-05-31T14:05:59.172Z","request_id":"90be5537-76f1-43c5-9f04-b8421792bc5f"},"status":"ok","message":"Icon retrieved","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":["Iconify"],"summary":"Search icons","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term, e.g. home","schema":{"type":"string"},"example":"home"},{"name":"prefix","in":"query","required":false,"description":"Restrict to one icon set, e.g. mdi","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results (1-100)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":32,"query":"home","total":32,"results":[{"id":"material-symbols:home","name":"home","prefix":"material-symbols","svg_url":"https://api.iconify.design/material-symbols:home.svg"},{"id":"material-symbols:home-outline","name":"home-outline","prefix":"material-symbols","svg_url":"https://api.iconify.design/material-symbols:home-outline.svg"},{"id":"material-symbols:home-outline-rounded","name":"home-outline-rounded","prefix":"material-symbols","svg_url":"https://api.iconify.design/material-symbols:home-outline-rounded.svg"},{"id":"material-symbols:home-rounded","name":"home-rounded","prefix":"material-symbols","svg_url":"https://api.iconify.design/material-symbols:home-rounded.svg"},{"id":"material-symbols-light:home","name":"home","prefix":"material-symbols-light","svg_url":"https://api.iconify.design/material-symbols-light:home.svg"},{"id":"material-symbols-light:home-outline","name":"home-outline","prefix":"material-symbols-light","svg_url":"https://api.iconify.design/material-symbols-light:home-outline.svg"},{"id":"material-symbols-light:home-outline-rounded","name":"home-outline-rounded","prefix":"material-symbols-light","svg_url":"https://api.iconify.design/material-symbols-light:home-outline-rounded.svg"},{"id":"material-symbols-light:home-rounded","name":"home-rounded","prefix":"material-symbols-light","svg_url":"https://api.iconify.design/material-symbols-light:home-rounded.svg"},{"id":"ic:baseline-home","name":"baseline-home","prefix":"ic","svg_url":"https://api.iconify.design/ic:baseline-home.svg"},{"id":"ic:outline-home","name":"outline-home","prefix":"ic","svg_url":"https://api.iconify.design/ic:outline-home.svg"},{"id":"ic:round-home","name":"round-home","prefix":"ic","svg_url":"https://api.iconify.design/ic:round-home.svg"},{"id":"ic:sharp-home","name":"sharp-home","prefix":"ic","svg_url":"https://api.iconify.design/ic:sharp-home.svg"},{"id":"ic:twotone-home","name":"twotone-home","prefix":"ic","svg_url":"https://api.iconify.design/ic:twotone-home.svg"},{"id":"mdi:home","name":"home","prefix":"mdi","svg_url":"https://api.iconify.design/mdi:home.svg"},{"id":"mdi:home-outline","name":"home-outline","prefix":"mdi","svg_url":"https://api.iconify.design/mdi:home-outline.svg"},{"id":"mdi-light:home","name":"home","prefix":"mdi-light","svg_url":"https://api.iconify.design/mdi-light:home.svg"},{"id":"line-md:home","name":"home","prefix":"line-md","svg_url":"https://api.iconify.design/line-md:home.svg"},{"id":"line-md:home-twotone","name":"home-twotone","prefix":"line-md","svg_url":"https://api.iconify.design/line-md:home-twotone.svg"},{"id":"solar:home-bold","name":"home-bold","prefix":"solar","svg_url":"https://api.iconify.design/solar:home-bold.svg"},{"id":"solar:home-bold-duotone","name":"home-bold-duotone","prefix":"solar","svg_url":"https://api.iconify.design/solar:home-bold-duotone.svg"},{"id":"solar:home-broken","name":"home-broken","prefix":"solar","svg_url":"https://api.iconify.design/solar:home-broken.svg"},{"id":"solar:home-line-duotone","name":"home-line-duotone","prefix":"solar","svg_url":"https://api.iconify.design/solar:home-line-duotone.svg"},{"id":"solar:home-linear","name":"home-linear","prefix":"solar","svg_url":"https://api.iconify.design/solar:home-linear.svg"},{"id":"solar:home-outline","name":"home-outline","prefix":"solar","svg_url":"https://api.iconify.design/solar:home-outline.svg"},{"id":"tabler:home","name":"home","prefix":"tabler","svg_url":"https://api.iconify.design/tabler:home.svg"},{"id":"tabler:home-filled","name":"home-filled","prefix":"tabler","svg_url":"https://api.iconify.design/tabler:home-filled.svg"},{"id":"boxicons:home","name":"home","prefix":"boxicons","svg_url":"https://api.iconify.design/boxicons:home.svg"},{"id":"boxicons:home-filled","name":"home-filled","prefix":"boxicons","svg_url":"https://api.iconify.design/boxicons:home-filled.svg"},{"id":"ri:home-fill","name":"home-fill","prefix":"ri","svg_url":"https://api.iconify.design/ri:home-fill.svg"},{"id":"ri:home-line","name":"home-line","prefix":"ri","svg_url":"https://api.iconify.design/ri:home-line.svg"},{"id":"mynaui:home","name":"home","prefix":"mynaui","svg_url":"https://api.iconify.design/mynaui:home.svg"},{"id":"mynaui:home-solid","name":"home-solid","prefix":"mynaui","svg_url":"https://api.iconify.design/mynaui:home-solid.svg"}]},"meta":{"timestamp":"2026-05-31T14:05:59.271Z","request_id":"f524d7a5-e548-483e-9ea4-3b47eeb4df3e"},"status":"ok","message":"Icons searched","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":"Source & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live Iconify data. /v1/search = search 200k+ icons (optionally within one set via prefix=); /v1/icon = an icon's SVG body, dimensions and a ready-to-use <svg> string (id is prefix:name, e.g. mdi:home); /v1/collections = browse the icon sets with their author, license and icon count. Each icon also has a direct .svg URL.","source":"Iconify — the open-source icon framework (api.iconify.design)","endpoints":["/v1/search","/v1/icon","/v1/collections","/v1/meta"]},"meta":{"timestamp":"2026-05-31T14:05:59.325Z","request_id":"760ec4ab-89bc-4d31-b5e0-e2c66220d3e4"},"status":"ok","message":"Meta retrieved","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":3590,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":435,"monthly_call_quota":48400,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1305,"monthly_call_quota":236000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3455,"monthly_call_quota":1194000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/iconify-api"}