One contract for every device. 38 operations across five capability groups, available as synchronous REST calls and real-time Callback webhooks.
All REST calls are made to a single versioned host.
https://api.camsunit.com/v3/
Every request carries an AuthToken scoped to your account and device. Keys are issued from the developer portal.
Form-encoded or JSON requests. Responses are JSON with predictable fields and error codes.
Two ways to integrate
You call the gateway and get an immediate answer. Perfect for fetching attendance, listing users, enrolling someone or opening a door on demand.
Register a URL and the gateway pushes events to you the instant a device reports them — no polling, with automatic retries on failure.
Operations
Grouped by what they do. Names map 1:1 to the underlying gateway endpoints.
All punches within a date range across the account.
Logs for a single employee code over a period.
Punches captured by one device serial number.
Per-day, per-employee summary (in/out, hours).
First-in / last-out pair per employee per day.
Live snapshot of today's punches.
Capture photos attached to a punch, where supported.
Bulk export for payroll & reconciliation.
Create a user on one or more devices.
Edit name, role, validity or privileges.
Remove a user from a device.
Look up a user by code, with optional credentials.
Enumerate everyone enrolled on a device.
Show which devices a user exists on.
Push a fingerprint template to the device.
Register a face template where supported.
Assign an RFID / proximity card to a user.
Set or change a device PIN / password.
Clone users & templates between devices.
Re-deliver a user's data to a device queue.
Trigger a door relay remotely in real time.
Lock / hold a door under your control.
Read the current open / closed state.
Define time-based access windows.
Entry / exit and door events log.
Inventory of every connected device.
Model, firmware, capacity and counters.
Online state, last-seen and queue depth.
Confirm reachability of a device now.
Align device clock with the server.
Restart a device remotely.
Clear stuck commands from the queue.
Track the state of a queued command.
Subscribe a webhook URL for live events.
Fired on every punch, in real time.
Online / offline & health transitions.
Confirmation when a template lands on a device.
Track bulk device / data migration progress.
Predictable responses
| Code | Meaning | What to do |
|---|---|---|
200 | Success | Process the JSON payload. |
401 | Invalid or missing AuthToken | Check the API key and device pairing. |
404 | Device or user not found | Verify the serial number / employee code. |
409 | Device offline / queued | Command is queued; poll GetCommandStatus. |
429 | Rate limited | Back off and retry with jitter. |
The quickstart walks you from API key to your first attendance log in minutes.