Quick Start

Send JSON, get a chart. No SDK, no dependencies, no API key needed to get started.

Your first chart

The smallest valid config – a version and one mark:

POST it and get back an SVG:

curl -X POST https://szum.io/chart \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"version":"2026-03-20","marks":[{"type":"barY","data":[{"x":"Mon","y":120},{"x":"Tue","y":150},{"x":"Wed","y":180},{"x":"Thu","y":140},{"x":"Fri","y":200}]}]}'

Embed anywhere images work

Use a GET request and drop it into an <img> tag – no SDK, no library:

<img src="https://szum.io/chart?config={...}" />

The response is a cacheable SVG. Works in emails, Notion, GitHub READMEs, Slack – anywhere images render.

Make it yours

Add a title, a theme, labels, and a second mark layer – all in the same config:

Notice data is top-level – both marks share it. The text mark adds value labels. Marks layer and compose.

Next steps

• API Endpoint – GET and POST reference, caching, errors
• Marks – bars, lines, dots, areas, text, rules
• Themes – 9 built-in themes, one property
• Config Reference – every field at a glance