Developer reference

Dialogue HR API

All endpoints are versioned, JWT-authenticated and rate-limited per organisation. Base URL: https://api.dialoguehr.com

v1 · stable
99.99% uptime
GDPR compliant

Authentication

POST
/v1/auth/login

Exchange employee number + password for a JWT.

Request
{
  "employeeNo": "M-2001",
  "password": "•••••••"
}
Response
{
  "token": "eyJhbGciOi…",
  "expiresIn": 3600,
  "user": { "id": "u_mgr", "role": "manager" }
}
POST
/v1/auth/reset

Trigger a password reset via email.

Request
{ "email": "james@…" }
Response
{ "ok": true }
Try it — cURL
curl -H "Authorization: Bearer $DHR_TOKEN" \
  https://api.dialoguehr.com/v1/cases
All endpoints available in the sandbox environment.