FairCheck HR in your Pocket

Accounts & users

Supporting endpoints under /api/v1 for authentication state, account listing,
and device notification tokens. These come from the underlying Jumpstart platform
and use the same bearer token and response envelope
as the rest of the API.

Sessions

  • POST /api/v1/auth — sign in with credentials, returns a token/session.
  • DELETE /api/v1/auth — sign out / revoke the current session.
  • PATCH /api/v1/password — update the current user's password.

Current user

  • GET /api/v1/me — the authenticated user's profile.
  • DELETE /api/v1/me — delete the current user's account.

Accounts

  • GET /api/v1/accounts — the accounts (tenants) the current user belongs to.
  • GET /api/v1/accounts/:id — a single account you are a member of.

Use an account's prefixed id with the X-Account-Id header (or account_id
param) to scope payslip requests to that tenant.

Users

  • POST /api/v1/users — create a user (sign-up).

Notification tokens

  • POST /api/v1/notification_tokens — register a device push token.
  • DELETE /api/v1/notification_tokens/:token — remove a device push token.

These endpoints are provided by the platform layer. The FairCheck-specific
surface you will use most is Payslips and
Webhooks.