Barcode Generator
Generate barcodes in multiple industry-standard formats. Returns a raw PNG image or base64-encoded JSON, supporting Code 128, Code 93, Code 39, EAN-8, and EAN-13.
Overview
Use Cases
- Product labeling and inventory management
- Retail point-of-sale systems
- Shipping and logistics labels
- Library and asset tracking systems
- Event ticketing and check-in workflows
Features
Five barcode formats (Code 128, Code 93, Code 39, EAN-8, EAN-13)
Dedicated endpoints for raw PNG and base64-encoded JSON
EAN types validate input length and digit-only content before encoding
Fixed 300Γ100 px output suitable for standard label widths
API Endpoints
Generate Barcode (PNG)
Returns a raw PNG image of the barcode. Ideal for direct embedding or file download.
GET
https://requiems.xyz/v1/technology/barcode
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| data | string |
Required | The text or numeric string to encode in the barcode |
| type | string |
Required | Barcode format: code128, code93, code39, ean8, ean13 |
Try it out
Live DemoRequest
The text or numeric string to encode in the barcode
Barcode format: code128, code93, code39, ean8, ean13
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| (binary) | bytes |
Raw PNG image bytes. Content-Type is image/png. |
Code Examples
# Save a Code 128 barcode as PNG
curl "https://requiems.xyz/v1/technology/barcode?data=123456789&type=code128" \
-H "requiems-api-key: YOUR_API_KEY" \
--output barcode.png
# Save an EAN-13 barcode (12 digits, checksum auto-calculated)
curl "https://requiems.xyz/v1/technology/barcode?data=123456789012&type=ean13" \
-H "requiems-api-key: YOUR_API_KEY" \
--output barcode.pngimport requests
url = "https://requiems.xyz/v1/technology/barcode"
headers = {"requiems-api-key": "YOUR_API_KEY"}
params = {"data": "123456789", "type": "code128"}
response = requests.get(url, headers=headers, params=params)
with open("barcode.png", "wb") as f:
f.write(response.content)const params = new URLSearchParams({
data: '123456789',
type: 'code128'
});
const response = await fetch(
`https://requiems.xyz/v1/technology/barcode?${params}`,
{ headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const blob = await response.blob();
const imgUrl = URL.createObjectURL(blob);require 'net/http'
uri = URI('https://requiems.xyz/v1/technology/barcode')
uri.query = URI.encode_www_form(data: '123456789', type: 'code128')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
File.write('barcode.png', response.body, mode: 'wb')Error Responses
400
bad_request
Missing or invalid parameters (e.g. data not provided, unsupported type)
422
unprocessable_entity
Data is invalid for the chosen barcode type (e.g. wrong digit count for EAN-8/EAN-13, non-numeric EAN data)
Generate Barcode (Base64 JSON)
Returns a JSON envelope containing the barcode as a base64-encoded PNG string, along with its type and dimensions.
GET
https://requiems.xyz/v1/technology/barcode/base64
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| data | string |
Required | The text or numeric string to encode in the barcode |
| type | string |
Required | Barcode format: code128, code93, code39, ean8, ean13 |
Try it out
Live DemoRequest
The text or numeric string to encode in the barcode
Barcode format: code128, code93, code39, ean8, ean13
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| image | string |
Base64-encoded PNG image data |
| type | string |
The barcode format that was used |
| width | integer |
Width of the generated image in pixels |
| height | integer |
Height of the generated image in pixels |
Code Examples
curl "https://requiems.xyz/v1/technology/barcode/base64?data=123456789&type=code128" \
-H "requiems-api-key: YOUR_API_KEY"import requests
url = "https://requiems.xyz/v1/technology/barcode/base64"
headers = {"requiems-api-key": "YOUR_API_KEY"}
params = {"data": "123456789", "type": "code128"}
response = requests.get(url, headers=headers, params=params)
result = response.json()["data"]
print(f"Image (base64): {result['image'][:40]}...")const params = new URLSearchParams({
data: '123456789',
type: 'code128'
});
const response = await fetch(
`https://requiems.xyz/v1/technology/barcode/base64?${params}`,
{ headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
// Use as an <img> src
document.getElementById('barcode').src = `data:image/png;base64,${data.image}`;require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/technology/barcode/base64')
uri.query = URI.encode_www_form(data: '123456789', type: 'code128')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
data = JSON.parse(response.body)['data']
puts data['image'][0..39] + '...'Error Responses
400
bad_request
Missing or invalid parameters (e.g. data not provided, unsupported type)
422
unprocessable_entity
Data is invalid for the chosen barcode type (e.g. wrong digit count for EAN-8/EAN-13, non-numeric EAN data)
Generate Barcodes (Batch)
Generate up to 20 barcodes in a single request. Each barcode is processed independently and results are returned in the same order as the input. Invalid items do not fail the entire request.
POST
https://requiems.xyz/v1/technology/barcode/batch
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| items | array<object> |
Required | Array of barcode generation requests. Min: 1, Max: 20. |
Try it out
Live DemoRequest
Array of barcode generation requests. Min: 1, Max: 20.
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| results | array<object> |
List of barcode generation results preserving input order |
| results[].image | string |
Base64-encoded PNG image |
| results[].type | string |
Barcode format used |
| results[].width | integer |
Image width in pixels |
| results[].height | integer |
Image height in pixels |
| results[].success | boolean |
Whether barcode generation succeeded |
| results[].error | string |
Error message when generation fails |
| total | integer |
Number of items processed |
Code Examples
curl -X POST https://requiems.xyz/v1/technology/barcode/batch \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"data": "123456789",
"type": "code128"
},
{
"data": "HELLO",
"type": "code93"
}
]
}'import requests
url = "https://requiems.xyz/v1/technology/barcode/batch"
response = requests.post(
url,
headers={
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"items": [
{
"data": "123456789",
"type": "code128"
},
{
"data": "HELLO",
"type": "code93"
}
]
}
)
print(response.json())const response = await fetch(
'https://requiems.xyz/v1/technology/barcode/batch',
{
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
items: [
{
data: '123456789',
type: 'code128'
},
{
data: 'HELLO',
type: 'code93'
}
]
})
}
);
const { data } = await response.json();
console.log(data.results);require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/technology/barcode/batch')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
items: [
{
data: '123456789',
type: 'code128'
},
{
data: 'HELLO',
type: 'code93'
}
]
}.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.bodyError Responses
validation_failed
Valid request body that fails validation (empty items array, more than 20 items, missing data field, or unsupported barcode type).
bad_request
Invalid JSON or malformed request body.
internal_error
Unexpected server error.
Frequently Asked Questions
Code 128 (alphanumeric, any length), Code 93 (alphanumeric, compact), Code 39 (alphanumeric, legacy), EAN-8 (7 or 8 digits), and EAN-13 (12 or 13 digits).
All barcodes are scaled to 300Γ100 pixels, which matches standard label dimensions for most use cases.
Code 128 supports the full ASCII character set including letters, digits, and symbols. It is the most flexible format and recommended for general use.
EAN-8 requires 7 digits (checksum auto-calculated) or 8 digits (checksum validated). EAN-13 requires 12 digits (checksum auto-calculated) or 13 digits (checksum validated). Only numeric characters are accepted.
GET /v1/technology/barcode returns a raw image/png binary β ideal for direct download or embedding with an <img> tag pointing at the API. GET /v1/technology/barcode/base64 returns a JSON envelope containing the base64-encoded image β useful when you need to embed the image inline in a JSON response or store the data in a database.