# Chartly

> Chartly is a REST API that turns Chart.js JSON configurations into PNG or SVG images. AI agents can call `POST https://api.chartly.dev/v1/chart/create` with an `X-Api-Key` header and a Chart.js config, and receive back a permanent CDN-served image URL suitable for embedding in chat replies, emails, PDFs, or dashboards.

Chartly is built on Cloudflare's edge network. The API surface is small — a handful of endpoints centered on `/v1/chart` and `/v1/chart/create`. There are no SDKs to install; any HTTP client works. Trial API keys are available without an account from `POST /signup/anon`.

If you are an LLM or agent indexing these docs, the single most useful file is [llms-full.txt](/llms-full.txt) — it concatenates every page below into one plain-text document.

## Docs

- [Introduction](https://docs.chartly.dev/): What Chartly is, quickstart in three steps, key features, and common use cases.
- [Getting Started](https://docs.chartly.dev/getting-started): Detailed walk-through from API key to first chart, including response handling and integration patterns.
- [API Reference](https://docs.chartly.dev/api): Every endpoint (`POST /v1/chart`, `GET /v1/chart`, `POST /v1/chart/create`, `GET /v1/chart/{id}`, `GET /v1/metrics/{id}`, `GET /v1/status`, `POST /signup/anon`), parameters, error codes, rate limits, and language examples.
- [Authentication & Security](https://docs.chartly.dev/authentication): Trial keys, production API keys, and HMAC-signed URLs with code samples.
- [Chart Types & Examples](https://docs.chartly.dev/chart-types): Chart.js JSON configs for bar, line, pie, doughnut, radar, polar area, scatter, bubble, and mixed charts.
- [Platform Integrations](https://docs.chartly.dev/integrations): Drop-in code for Node.js, Express, Next.js, Python (Flask/Django/FastAPI), React, React Native, Flutter, Slack, email, Zapier, Make.com, and Bubble.io.
- [Usage & Billing](https://docs.chartly.dev/usage-billing): Plans (Trial, Starter, Growth, Enterprise), monthly limits, dimension caps, cache durations, and SLA terms.
- [Troubleshooting](https://docs.chartly.dev/troubleshooting): Solutions for 401, 429, invalid config, render-failure, and network errors.
- [AI Agents & LLMs](https://docs.chartly.dev/ai-agents): Tool/function definitions for Anthropic and OpenAI tool calling, end-to-end agent example, and prompting tips.

## API

- [OpenAPI JSON](https://api.chartly.dev/openapi.json): Machine-readable OpenAPI 3 schema.
- [OpenAPI YAML](https://api.chartly.dev/openapi.yaml): Same schema in YAML.
- [Interactive API explorer](https://api.chartly.dev): Browser-based playground.

## Optional

- [Chartly homepage](https://chartly.dev): Marketing site, sign-up, and dashboard.
- [Status page](https://status.chartly.dev): Live service status.