Skip to content

Barcodes

Base route: /api/v1/barcodes

Saved barcodes are static tenant assets. They are protected by the current workspace membership, role, subscription and API-key scope on every call.

Method Endpoint Scope Purpose
GET /api/v1/barcodes barcode:read List/search/filter saved barcodes.
GET /api/v1/barcodes/{id} barcode:read Retrieve one barcode and safe SVG preview.
POST /api/v1/barcodes barcode:write Create a saved barcode.
PUT /api/v1/barcodes/{id} barcode:write Update value/name/appearance.
GET /api/v1/barcodes/{id}/download?format=png barcode:read Download PNG, SVG or PDF.
DELETE /api/v1/barcodes/{id} barcode:delete Soft-delete a barcode.

Supported standards: Code128, Ean13, UpcA, Ean8, Code39, Itf14. GS1-style formats validate or calculate their check digit.

{
  "name": "Warehouse SKU 4821",
  "format": "Code128",
  "value": "SKU-4821",
  "style": {
    "showText": true,
    "height": 96,
    "scale": 3,
    "foregroundColor": "#102A2A",
    "backgroundColor": "#FFFFFF"
  }
}

The renderer is server-side, bounded and network-independent. QRalto rejects invalid standards, oversized values/exports and unsafe low-contrast colour combinations.