Get started with QR Code Agency
Everything a developer needs to ship the first integration in under an hour.
Get started
Four short reads stand between you and a production integration.
- Step 1: Quickstart
Make your first QR in five minutes. Curl, Python, JavaScript, Node.js, C#, and Go snippets ready to copy.
- Step 2: Authentication
How X-Api-Key works, how to create and rotate keys, where to store
them, and why you should never call us directly from a browser.
- Step 3: Plans and limits
What is free, what each tier costs, what the size and DPI caps are, and how monthly quota plus credit packs interact.
- Step 4: SDKs and clients
Official TypeScript SDK, community Python and Go libraries, plus a minimal openapi.json you can feed to your generator of choice.
When you finish, jump to Concepts for the deeper material or to the API reference for the parameter-by-parameter view.
Prerequisites
You will need:
- A QR Code Agency account (sign up)
- One API key (create)
- Any HTTP client. We test against curl, Python
requests, browserfetch, Nodefetch, .NETHttpClient, and Gonet/http. There is no special transport, just JSON over HTTPS.
Estimated time
| Task | Time |
|---|---|
| Sign up and create a free key | 2 min |
| Quickstart (first PNG on disk) | 5 min |
| Wire authentication into your code | 10 min |
| Build a real feature (dynamic QR + analytics) | 1-2 hours |
Glossary
| Term | Meaning |
|---|---|
| Static QR | The encoded data is the destination. Cannot change after print. |
| Dynamic QR | The encoded data is q.qrstudio.agency/q/<short_id>/. Destination is repointable any time. |
| Render cache | 24 hour content-addressed cache. Same params + same logo bytes return instantly. |
| Quota | Number of successful 200 responses you can spend per calendar month. |
| Overage | Extra renders on Starter and Pro charged per unit when quota is exhausted. |
| Credit pack | Prepaid block of renders that never expires. Useful for occasional use without a subscription. |
| Scan | One scan = one HTTP hit to q.qrstudio.agency/q/<short_id>/. Logged with country, device, referer. |