PARiM Clocking API

Name: PARiM Clocking API
Brand: PARiM Clocking API
Availability: InStock

✓ Official Vendor SpecWorkforce ManagementTime Trackingcustom2 EndpointsREST

For Agents

Record employee clock events and retrieve user lists for workforce scheduling and attendance tracking in PARiM.

Use for: I need to clock in an employee at a job site, Record a break start for a worker, Get a list of all active staff members, Submit a clock-out event with GPS coordinates

Not supported: Does not create shifts, manage schedules, or handle payroll calculations — use only for recording attendance events and retrieving user lists. Shift existence is a prerequisite.

Install Jentic One Beta

Connect the PARiM Clocking API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the PARiM Clocking API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with PARiM Clocking API.

Submit clock events including clock in, clock out, break start/end, check-in, and checkpoint check-in

Record geolocation (latitude, longitude, accuracy) alongside clock events for location verification

Associate clock events with published shifts by user and timestamp

GET STARTED

Start building with PARiM Clocking API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use PARiM Clocking API for, with concrete tasks.

★ Mobile Time Clock Integration

Build a mobile app or kiosk that lets staff clock in and out of shifts without direct PARiM access. POST /clock_events accepts timestamp, location, and event type; PARiM validates against published shifts and records attendance. The signature-based auth ensures only authorized devices can submit clock events on behalf of users.

POST /clock_events with type, user_id, exact_timestamp, latitude, and longitude. Ensure the domain subdomain matches the PARiM instance and the signature headers are correctly computed.

Workforce Synchronization

Sync staff rosters between PARiM and an external HR or payroll system by periodically fetching the user collection. GET /users returns all active, approved, and incomplete users with their external IDs and PARiM UUIDs, allowing bidirectional lookups. Use external_id to map PARiM users to records in your system.

GET /users and iterate the returned array, using external_id and parim_id to reconcile with your HR database.

Key Endpoints

2 endpoints — parim clocking api enables workforce scheduling and time-tracking integration by allowing external applications to submit clock events (clock in, clock out, breaks, check-ins) and retrieve user information for staff members.

METHOD

PATH

DESCRIPTION

POST

/clock_events

Submit a new clock event (clock in, out, break, or check-in)

GET

/users

Retrieve the collection of users (staff, candidates, subcontractors)

POST

/clock_events

Submit a new clock event (clock in, out, break, or check-in)

GET

/users

Retrieve the collection of users (staff, candidates, subcontractors)

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

PARiM API keys and secret for signature generation are stored encrypted in Jentic's vault and used to compute the x-auth-parim-signature header at execution time without exposing them in prompts or logs.

Intent-based discovery

Agents search by intent such as 'clock in an employee parim' or 'get parim user list' and Jentic returns the matching endpoint with schema and example signatures.

Time to first call

Direct PARiM integration: 1-2 days to implement the custom signature auth. Through Jentic: under 1 hour — search, load schema, execute with signature handled automatically.

FAQs

Specific to using PARiM Clocking API through Jentic.

What authentication does the PARiM Clocking API use?

The API uses a custom signature-based authentication with five required headers: x-auth-parim-key (public API key), x-auth-parim-timestamp (current unix timestamp), x-auth-parim-nonce (unique value), x-auth-parim-signature (HMAC signature), and X-PARiM-Domain (subdomain). Jentic can store the key and secret and construct the signature headers at execution time.

Can I submit clock events for any user?

No. Clock events require a published shift to exist for the user at the specified time. If no published shift is found, the API returns HTTP 428. This ensures clock events are tied to actual work schedules.

Does the API support geolocation for clock events?

Yes. Each clock event can include latitude, longitude, and accuracy (in meters). These fields are optional but recommended for location verification of mobile clocking.