Get Barcode

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

string

required

The UUID of the attestation

integer

default:"300"

Image width in pixels (100 to 800)

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

Scenario	Use QR	Use Barcode
Digital certificates	Yes	No
Physical labels	Maybe	Yes
Supply chain	No	Yes
Email badges	Yes	No
Access cards	Either	Either
Mobile sharing	Yes	No

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

const barcodeImage = await client.attestations.getBarcode(attestationId, {
  width: 400,
  height: 100
});
fs.writeFileSync('attestation-barcode.png', Buffer.from(barcodeImage));

Attestations

Receipts

Risk Evaluation

Risk Signals

Account Takeover

Velocity Scoring

Verification

Verification Packs

Issuers

API Keys

Policies

Issuer Applications

Identity & Access

Webhooks

Audit & Logs

Consumer (B2C)

Billing

Machine Agents

Agent Sessions & Tools

Trust & Witness

Truth Claims & Documents

Compliance & Anomalies

Datasets & Models

Orchestrations & Workflows

Guardrails & Delegation

MAIP Policies

Observability

Assets

Governance

Announcements

Blog Management

Leads

System

Use cases

Parameters

Response

Encoded data

QR code vs barcode: when to use which

​Use cases

​Parameters

​Response

​Encoded data

​QR code vs barcode: when to use which

Use cases

Parameters

Response

Encoded data

QR code vs barcode: when to use which