REST API

A JSON API over the full library: search, fetch SVG (optionally recolored), and browse packs. Base URL: https://iconsroom.com/api/v1. CORS-open.

The API is part of the Pro toolkit — authenticate with your IR- license token. Get a license. Please cache responses and stay within fair-use rate limits (60 searches/min, 120 icon fetches/min per IP).

Authentication

Send your license token as a bearer token:

Authorization: Bearer IR-XXXXXXXXXXXXXXXX

Endpoints

GET /api/v1/search

Keyword search across all packs.

curl "https://iconsroom.com/api/v1/search?q=arrow&limit=20" \
  -H "Authorization: Bearer IR-XXXXXXXXXXXXXXXX"

Query params: q (required), limit (default 20), pack (optional — scope to one pack).

GET /api/v1/icon/{pack}/{name}

Fetch one icon. Returns SVG markup and metadata; recolor monochrome icons on the fly.

curl "https://iconsroom.com/api/v1/icon/tabler/home?color=%230651fb" \
  -H "Authorization: Bearer IR-XXXXXXXXXXXXXXXX"

GET /api/v1/packs

List all 220 packs with icon counts, categories and licenses.

curl "https://iconsroom.com/api/v1/packs" \
  -H "Authorization: Bearer IR-XXXXXXXXXXXXXXXX"

POST /api/v1/auth/verify

Check that a license token is valid (used by the integrations themselves).

curl -X POST "https://iconsroom.com/api/v1/auth/verify" \
  -H "Content-Type: application/json" \
  -d '{"token": "IR-XXXXXXXXXXXXXXXX"}'

// → { "valid": true, "plan": "lifetime", "since": "…" }

Icon CDN

Raw SVGs are also served from the CDN at https://files.svgcdn.io/{pack}/{name}.svg — handy for <img> tags and CSS. Each icon's page on the site shows its exact CDN URL.

Licensing

API responses include each icon's pack license. Most are MIT/Apache/CC BY; the few non-commercial packs are flagged. See licensing.