Skip to main content
GET
/
v1
/
attestations
/
{id}
/
barcode
curl -H "Authorization: Bearer $API_KEY" \
  "https://api.truthlocks.com/v1/attestations/550e8400-e29b-41d4-a716-446655440000/barcode?width=400&height=100" \
  --output attestation-barcode.png
Generate a Code 128 barcode image for an attestation. The barcode encodes only the attestation ID, making it compact enough for physical labels, receipts, and packaging.

​
Use cases

  • Supply chain labels and inventory tags
  • Physical receipts and access cards
  • Printed documents where space is limited
  • Barcode scanner-friendly environments (warehouses, retail)

​
Parameters

​
id
string
required
The UUID of the attestation
​
width
integer
default:"300"
Image width in pixels (100 to 800)
​
height
integer
default:"80"
Image height in pixels (40 to 200)

​
Response

Returns a PNG image with Content-Type: image/png. The response includes aggressive cache headers (Cache-Control: public, max-age=31536000, immutable) since barcodes for a given attestation never change.

​
Encoded data

The barcode contains the raw attestation UUID string. To verify, scan the barcode with any Code 128 reader, then look up the attestation using the ID.

​
QR code vs barcode: when to use which

ScenarioUse QRUse Barcode
Digital certificatesYesNo
Physical labelsMaybeYes
Supply chainNoYes
Email badgesYesNo
Access cardsEitherEither
Mobile sharingYesNo
curl -H "Authorization: Bearer $API_KEY" \
  "https://api.truthlocks.com/v1/attestations/550e8400-e29b-41d4-a716-446655440000/barcode?width=400&height=100" \
  --output attestation-barcode.png