Batches

A batch is a physical shipment of devices arriving at your facility — typically from an approved quote.

Where to find it

Admin: /process/batches Portal: /portal/batches API: /api/v1/batches

Batch lifecycle

Batch fields

• referenceName — human-readable label (e.g. "Lincoln Elementary Spring 2026")
• sid — source ID (which client it's from)
• uid — user who created the batch
• dateExpected — ETA
• quantityExpected — how many devices expected

Workflow

1. Create batch — set reference name, expected quantity, expected date
2. Receive shipment — mark batch as Received
3. Scan devices in — use mobile app or admin UI to scan IMEIs/serials into the batch
4. Inspect each device — technician runs diagnostics, sets grade, uploads photos (see Device Inspection)
5. Complete batch — POST /batches/{id}/complete once all devices are processed
6. Pay the client — based on the quote and actual grades received

Discrepancies

If quantityExpected ≠ actual device count, the batch may be flagged for escalation. Similarly, if graded value is significantly different from quoted value, admins review before paying.

Related features

• Device Inspection
• Quotes
• Mobile app intake workflow — scan devices on the go