{"openapi":"3.0.3","info":{"title":"Orca Scan Barcode Image API","description":"Free API to generate barcode images on-the-fly. No authentication required.","version":"1.0.0","contact":{"name":"Orca Scan","url":"https://orcascan.com"}},"servers":[{"url":"https://barcode.orcascan.com","description":"Production"}],"externalDocs":{"description":"Full guide","url":"https://orcascan.com/guides/free-barcode-image-api-0e4a4fa6"},"paths":{"/":{"get":{"summary":"Generate a barcode image","description":"Returns a barcode image in the requested format","operationId":"generateBarcode","externalDocs":{"description":"Full guide","url":"https://orcascan.com/guides/free-barcode-image-api-0e4a4fa6"},"parameters":[{"name":"type","in":"query","description":"Barcode type or custom design name.","required":false,"schema":{"type":"string","enum":["qrcode","datamatrix","ean13","ean8","upca","upce","code128","code39","code93","itf","pdf417","aztec"],"default":"qrcode"},"examples":{"qrcode":{"summary":"QR Code","value":"qrcode"},"datamatrix":{"summary":"Data Matrix","value":"datamatrix"},"ean13":{"summary":"EAN-13","value":"ean13"},"code128":{"summary":"Code 128","value":"code128"},"pdf417":{"summary":"PDF417","value":"pdf417"}}},{"name":"data","in":"query","description":"Content to encode in the barcode.","required":false,"schema":{"type":"string"},"examples":{"url":{"summary":"URL","value":"https://orcascan.com"},"text":{"summary":"Plain text","value":"Hello, World!"}}},{"name":"text","in":"query","description":"Human-readable label displayed below the barcode.","required":false,"schema":{"type":"string"}},{"name":"format","in":"query","description":"Output image format.","required":false,"schema":{"type":"string","enum":["svg","png","jpg","jpeg","tiff","gif","webp","pdf"],"default":"svg"}},{"name":"background","in":"query","description":"Background colour as a 6-character hex string without the # prefix. Use none for transparent.","required":false,"schema":{"type":"string","pattern":"^([a-fA-F0-9]{6}|none)$"},"examples":{"white":{"summary":"White","value":"ffffff"},"transparent":{"summary":"Transparent","value":"none"}}},{"name":"padding","in":"query","description":"Padding around the barcode in pixels.","required":false,"schema":{"type":"integer","default":26}},{"name":"fontsize","in":"query","description":"Font size for the label text in pixels, or fit to auto-size to the barcode width.","required":false,"schema":{"type":"string","default":"fit"}},{"name":"layout","in":"query","description":"Pass landscape to rotate the output 90 degrees.","required":false,"schema":{"type":"string","enum":["landscape"]}},{"name":"b64","in":"query","description":"Set to true to return the image as a base64-encoded string (text/plain) instead of binary.","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"}},{"name":"download","in":"query","description":"Set to true to add a Content-Disposition header that triggers a file download in the browser.","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"Barcode image in the requested format, or a base64 string when b64=true.","content":{"image/svg+xml":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/gif":{"schema":{"type":"string","format":"binary"}},"image/tiff":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}},"text/plain":{"description":"Base64-encoded image, returned when b64=true.","schema":{"type":"string","format":"byte"}}}},"400":{"description":"Invalid parameter value. The response body is an SVG error image.","content":{"image/svg+xml":{"schema":{"type":"string"}}}}}}}}}