Generate a single GS1 DataMatrix

Render a GS1 DataMatrix for a GTIN plus any subset of (lot, serial, expiry). At least one of lot or serial is required. Returns image bytes (image/svg+xml, image/png, or application/pdf).

Caching: responses are deterministic given the request body. The endpoint sets Cache-Control: public, max-age=2592000 (30 days) and a strong ETag over the image bytes. Clients sending If-None-Match with a matching ETag get 304 Not Modified.

POST /products/api/v1/datamatrix

Generate a single GS1 DataMatrix

cURL

curl --request POST \
  --url https://www.closient.com/products/api/v1/datamatrix/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "gtin": "<string>",
  "lot": "<string>",
  "serial": "<string>",
  "expiry": "<string>",
  "format": "svg"
}
'

200

"<string>"

Authorizations

APIKeyHeaderAuthOAuthTokenAuthSessionAuth

X-API-Key · string · header · required

Body

application/json

Request body for synchronous GS1 DataMatrix generation.

gtin · string · required

GTIN (8/12/13/14 digits, normalized to GTIN-14).

lot · string | null

Optional GS1 AI(10) lot/batch (1-20 printable ASCII).

serial · string | null

Optional GS1 AI(21) serial (1-20 printable ASCII).

expiry · string | null

Optional GS1 AI(17) expiry as YYMMDD (e.g. '270630' for 2027-06-30).

format · enum<string> · default: svg

Output image format. svg is the default scalable vector output; png is raster output; pdf is single-page vector PDF for print workflows (C-2852) — path operators in the content stream rather than a rasterised preview, so a print shop can scale to its target label size at the press.

Available options: svg, png, pdf

Response

200

application/json

OK

The response is of type file.