Skip to main content

​
Signal Tags integration

Integrate Signal Tags product authentication with the Better Data platform — verification outcomes that start or advance loops in the Loop Engine.

​
Overview

Signal Tags bridge physical scans to digital governance. A scan produces a verification result; your integration maps that result to loop transitions (quarantine, investigation, release, etc.).

​
Install (schema)

npm install @betterdata/signal-tags-schema
A dedicated @signal-tags/verify client may publish in a future release. Today, call verify.betterdata.co with your HTTP client and validate responses against @betterdata/signal-tags-schema where applicable.

​
Configure verification

Point your integration at the hosted verification base URL: 
const VERIFY_BASE = process.env.SIGNAL_TAGS_VERIFY_URL ?? "https://verify.betterdata.co";
// Implement GET/POST to your contracted verification route; attach org credentials as required.

​
Verify a tag (pattern)

type VerifyStatus = "authentic" | "tampered" | "expired" | "recalled" | string;

interface VerificationResponse {
  status: VerifyStatus;
  tagId: string;
  verifiedAt: string;
  // Plus contract-specific fields (lot, product, chain-of-custody, etc.)
}

async function verifyTag(tagId: string): Promise<VerificationResponse> {
  const res = await fetch(`${VERIFY_BASE}/v1/verify/${encodeURIComponent(tagId)}`, {
    headers: { Authorization: `Bearer ${process.env.SIGNAL_TAGS_TOKEN!}` },
  });
  if (!res.ok) throw new Error(`verify failed: ${res.status}`);
  return res.json() as Promise<VerificationResponse>;
}

​
Triggering loops from verification

const result = await verifyTag(tagId);

switch (result.status) {
  case "authentic":
    // proceed with sale / fulfillment
    break;
  case "recalled":
    // await loopSystem.startLoop({ definitionId: "quarantine", context: { tagId } })
    break;
  case "tampered":
    // investigation / brand-protection loop
    break;
}
Wire loopSystem to your Loop Engine integration (Loops, Hosted Loop Engine).

​
Industry applications

IndustryUse case
PharmaceuticalDSCSA serialization, recall handling
HealthcareUDI traceability
RetailAnti-counterfeit, luxury authentication
Food & beverageFarm-to-shelf traceability
ConstructionMaterials provenance

​
Hosted verification

The hosted endpoint at verify.betterdata.co adds HA operations, compliance-oriented reporting, and optional anchoring features (per contract).
Contact hello@betterdata.co for access. → Signal Tags (platform)
→ Signal Tags OSS
→ tagd.sh