API

Launch product verification without rebuilding your stack.

Mint identities in bulk. Get notified when scans happen. Plug Pearpin into your existing systems with REST, webhooks and idempotent retries — no packaging-workflow rewrite.

Endpoints + dev features

Bulk creation, scan events and webhooks.

Mint identities in one call. Get notified the moment a scan happens. Retry safely with idempotency keys and tune sensitivity per category.

create-units.ts

// Generate 10,000 unit identities in a single call.
const res = await fetch("https://api.pearpin.com/v1/units", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PEARPIN_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "batch-2049-create"
  },
  body: JSON.stringify({
    sku: "PEAR-SHAMPOO-200ML",
    batch: "B-2049",
    expires: "2027-08",
    count: 10_000
  })
});

const { units } = await res.json();
// units[0].verificationUrl
//   → https://verify.pearpin.com/u/PRP-8K29

Endpoints

POST
/v1/units
Create unit identities (single or bulk batch)
POST
/v1/scans/events
Emit a scan event
GET
/v1/units/{id}
Fetch identity, batch and lifecycle state
GET
/v1/units/{id}/risk
Current risk score and signal breakdown
POST
/v1/webhooks
Register webhook endpoints for events

Developer features

Tenant-scoped API keys with rotation
Webhook signing + replay protection
Bulk unit creation in a single call
Brand-controlled scan pages
Idempotency keys on every mutation
Sandbox environment with synthetic scans

Two paths to identity

Bulk APIs today. Offline SDK on integration.

Most brands start by minting unit identities through the bulk API and dropping codes into their existing print or pack workflow. Brands ready to integrate at the manufacturing line move to the deterministic Offline SDK.

Phase 1 · today

Bulk APIs

Mint identities in batches with one call. Drop the codes into your existing packaging workflow. Webhooks deliver scan events back to your systems as they happen.

· Tenant-scoped keys with rotation
· Idempotency keys on every mutation
· Webhook signing + replay protection

Phase 2 · manufacturer integration

Offline SDK · deterministic generation

When the manufacturer integrates, Pearpin generates every unit identity at print time using a deterministic formula. No QR file distribution. No shared datasets. Read the /sdk page for the full story.

· Works offline; no per-unit API call
· Production-line speed
· Per-manufacturer secret with scheduled rotation

Ready when you are

Ready to launch with Pearpin?

Get sandbox access for the bulk-API surface or talk to engineering about SDK integration on your manufacturing line.

Get sandbox access Talk to engineering