Barcode Generation

• datastringrequired

  Data string to encode in the barcode

• typestringoptional

  Default: code128.

  Barcode format: code128, ean13, ean8, upca, code39

  • code128
  • ean13
  • ean8
  • upca
  • code39
• format"svg" | "png"optional

  Default: svg.

  Output format: svg or png

• widthnumberoptional

  Default: 2.

  Bar unit width in pixels (1–5)

• heightnumberoptional

  Default: 100.

  Bar height in pixels (50–300)

• colorstringoptional

  Default: #000000.

  Bar color in hexadecimal (e.g. 000000)

• bgstringoptional

  Default: #ffffff.

  Background color in hexadecimal (e.g. ffffff)

By default (format=svg), the endpoint returns an inline SVG image (Content-Type: image/svg+xml), usable in an <img> tag:

<img src="https://api.moxon.dev/v5/barcode?data=Hello123" alt="Barcode" />

With format=png, the response is a raw PNG buffer (Content-Type: image/png):

<img src="https://api.moxon.dev/v5/barcode?data=Hello123&format=png" alt="Barcode" />

• 400Please provide data to encode (?data={string})The data parameter is missing
• 400Type must be one of: code128, ean13, ean8, upca, code39The type value is not valid
• 400Format must be one of: svg, pngThe format value is not valid
• 400Width must be between 1 and 5The width parameter is out of the allowed range
• 400Height must be between 50 and 300The height parameter is out of the allowed range
• 400Please provide valid dimensions (&width={px}&height={px})The width or height parameter is not a valid number
• 400Code 128 only supports ASCII 32-126 (invalid char: "{ch}")A character in data is outside the Code 128 supported range
• 400EAN-13 requires 12 or 13 digitsThe data string does not have the correct number of digits
• 400Invalid EAN-13 check digit (expected {expected}, got {actual})The provided EAN-13 check digit does not match the computed value
• 400EAN-8 requires 7 or 8 digitsThe data string does not have the correct number of digits
• 400Invalid EAN-8 check digit (expected {expected}, got {actual})The provided EAN-8 check digit does not match the computed value
• 400UPC-A requires 11 or 12 digitsThe data string does not have the correct number of digits
• 400Code 39 invalid character: "{ch}". Allowed: A-Z, 0-9, space, - . $ / + %A character in data is not allowed in Code 39
• 400Invalid color (use hex like ff6600)A color or bg value is not a valid hexadecimal color