POST

/api/v1/qr/batch

Generate up to 1,000 at once

POST /api/v1/qr/batch takes a shared style and a list of items, each of which may be a raw payload or a typed one, and returns them together. Per-item style overrides are merged over the shared style, so one request covers a whole print run.

View as MarkdownPaste this page into any AI assistant — it is plain, portable Markdown.

Request

POST /api/v1/qr/batch

POST endpoints are not run from this page — copy the cURL from /developers.

Parameters

Name	Type	Detail
itemsREQUIRED	string	Up to 1,000 items.
style	string	Shared style, overridable per item.
output	enum · url	How each result comes back.url · base64 · json

When you get it wrong

Errors are RFC 9457 problem+json with one addition: a fix field containing a corrected call you can run as-is.

{
  "type": "https://useqr.app/errors",
  "title": "Too many items",
  "status": 400,
  "detail": "1,400 items exceeds the 1,000 per request limit",
  "fix": "split the list into two requests of 700"
}