Skip to main content
POST
/
products
/
api
/
v1
/
qr
Generate a single QR code
curl --request POST \
  --url https://www.closient.com/products/api/v1/qr/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "gtin": "<string>",
  "lot": "<string>",
  "serial": "<string>",
  "expiry": "<string>",
  "format": "png",
  "size": 400
}
'
"<string>"

Documentation Index

Fetch the complete documentation index at: https://docs.closient.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Request body for the synchronous single-QR endpoint.

Encodes a GS1 Digital Link URL as a QR code. The gtin is the only required identifier; lot, serial, and expiry are GS1 Application Identifier values that, when present, are appended to the Digital Link path/query so a phone scan resolves to the most specific instance available.

​
gtin
string
required

GTIN barcode (GTIN-8, 12, 13, or 14, with or without separators). Normalized to GTIN-14 server-side before encoding into the Digital Link URL.

Required string length: 8 - 17
Pattern: ^[\d\s\-]{8,17}$
​
lot
string | null

Optional GS1 AI(10) lot/batch identifier — 1-20 printable ASCII chars, no spaces. Encoded into the Digital Link path as /10/{lot}. When present alongside serial, both are added (lot before serial).

Required string length: 1 - 20
Pattern: ^[\x21-\x7E]{1,20}$
​
serial
string | null

Optional GS1 AI(21) serial identifier — 1-20 printable ASCII chars, no spaces. Encoded into the Digital Link path as /21/{serial}. Use serial for unit-level traceability when each item carries a unique tag.

Required string length: 1 - 20
Pattern: ^[\x21-\x7E]{1,20}$
​
expiry
string | null

Optional GS1 AI(17) expiry date as YYMMDD — exactly 6 digits (e.g. 261231 for 2026-12-31). Encoded into the Digital Link query as ?17={expiry}.

Required string length: 6
Pattern: ^\d{6}$
​
format
enum<string>
default:png

Output image format. svg for resolution-independent vector output (size ignored); png for raster output sized by size.

Available options:
svg,
png
​
size
integer
default:400

Target image side length in pixels (50-2000). QR codes are square, so this is both width and height. Ignored when format='svg' (vector output is resolution-independent).

Required range: 50 <= x <= 2000

Response

OK

The response is of type file.