API

Employees

Read employee lists and records for payroll mapping.

Read employee lists and individual records for payroll mapping and reporting.

GET /api/v1/companies/{companyId}/users
Authorization: Bearer {token}

Roles: owner, manager, accountant, superadmin

Response: filtered public view — see Limits & security.

Single employee

GET /api/v1/companies/{companyId}/users/{userId}

Roles: Same as list. employee may read only themselves.

Example response

{
  "success": true,
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "email": "jane@company.example",
      "role": "employee",
      "isActive": true,
      "employeeProfile": {
        "displayName": "Jane Doe",
        "jobTitle": "Supervisor",
        "departments": [{ "id": "…", "name": "Sales" }],
        "employmentStartDate": "2022-03-01",
        "employmentEndDate": null,
        "employmentRatio": 100
      }
    }
  ],
  "errors": null
}

Integration tips

Goal Approach
Map to payroll system Use id as Curio identifier; map external employee numbers in Curio settings
Filter inactive Check isActive and employmentEndDate
Department grouping employeeProfile.departments

Not in public API v1

  • POST / PUT / DELETE users
  • Documents, AI companion
  • Kiosk PIN (use Punch clock instead)