Registration & Serial Numbers API

Use these endpoints to look up product registrations and validate serial numbers for warranty coverage.

Look up a registration

GET /api/public/registration/lookup

Query parameters:

• registrationNumber (required) — e.g., UMB-REG-00089
• orgId (required) — organization ID

Returns the registration record including product details, customer info, status, purchase date, and associated warranty.

Registration statuses

Registration flow

1. Customer submits registration via POST /api/public/products/register (see Products API)
2. System validates product and customer data, creates a registration with pending status
3. Customer receives a confirmation email with their registration number
4. Merchant reviews and approves or denies in the dashboard
5. Customer can check status using this lookup endpoint

Validate a serial number

POST /api/public/serial-numbers/validate

Required body fields: serialNumber, orgId

Returns { "valid": true } with the serial number details (product ID, warranty ID, validity dates) if valid.

If invalid, returns { "valid": false } with the reason: already registered, expired, revoked, not yet valid, registration period ended, or not found.

Serial number statuses

Uploading serial numbers in bulk

Serial numbers are uploaded via CSV in the dashboard:

1. Go to Dashboard > Serial Numbers > Upload
2. Upload a CSV with columns: serialNumber (required), productId, warrantyId, validFrom, validUntil

Serial numbers must be unique within an organization. Large batches process asynchronously.

Related

• Products API — Product registration endpoint
• Warranty API — Warranty plan details
• Authentication — API credentials