Skip to content
Voxbi Cockpit APIs
API Guides

Badges

A badge in Tempus is the credential an employee uses to clock in or out at a terminal: usually a physical RFID/NFC card, sometimes a barcode, sometimes a virtual token in the Voxbi app. One employee can have multiple badges, but each badge belongs to exactly one user.

Overview

The Badges page is the registry of every badge issued on the tenant, where you create, edit, activate, deactivate, and trash badges. To register a card, read its UID from the device, paste it into Badge data, link it to the user, and set it active. The badge is then live at every terminal.

What it does

When an employee taps a badge, the terminal reads the badge data, looks up the matching record, confirms it is active, and writes a time point for the linked user. If the record is inactive or the data matches nothing, the tap is rejected silently. Badge data must be unique on the tenant and is case-sensitive.

For a lost or stolen card, set Is active = off immediately, then register a new badge with the replacement card's UID.

See also

Form fields

Fields available in the create and edit forms.

General

Employee

The user this badge is assigned to. Each badge belongs to exactly one user.

Badge ID

Unique identifier stored on the physical badge, read by the scanner on tap. Must be unique across all badges on the tenant.

Badge alias

Human-readable label for the badge, useful when a user has more than one (for example, "Office badge" or "Warehouse badge").

Active

When off, the badge is rejected at every terminal. Deactivate to retire a card without deleting its history.

Updated