Staff directory and human resource management with organizational structure

This comprehensive HR endpoint provides complete staff management including:

• Employee directory with advanced search capabilities
• Department and organizational structure integration
• Role-based staff categorization and filtering
• Active/inactive employee status management
• Multi-field name search with partial matching

HR Management Capabilities:

• Complete employee directory with contact information
• Department-based organizational structure tracking
• Staff type and role classification system
• Active employee status for current workforce analysis
• Employee search across first and last names

Organizational Features:

• Department hierarchy and staff allocation
• Role-based access and staff type categorization
• Employee status management (active/inactive)
• Contact information and communication data
• Staff reference and external system integration

Search and Filter Options:

• Multi-field name search (first name, last name)
• Department-based staff filtering
• Active status filtering for current employees
• Role and staff type categorization
• Alphabetical sorting for directory listings

Business Applications:

• Employee directory and contact management
• HR reporting and organizational analysis
• Department staff allocation and planning
• Employee onboarding and management workflows
• Integration with external HR and payroll systems

Directory Features:

• Complete contact information management
• Department and role relationship tracking
• Staff reference system for external integration
• Employee status and lifecycle management

Real Example:

curl --location 'https://{{host}}/v1/staff' \
--data '{
  "pageSize": 25,
  "page": 0
}'

Permissions:

Advanced staff filtering with custom GraphQL where clauses and dynamic ordering

Provides flexible, enterprise-grade filtering for staff directory queries with boolean logic, relationship traversal, and multi-field ordering.

Key capabilities include boolean operators (_and, _or, _not), text matching (_ilike), comparison operators (_gt, _gte, _lt, _lte, _eq, _neq), array operators (_in, _nin), and nested/related filtering (e.g., by office or manager).

Real Example:

curl --location 'https://{{host}}/v1/staff/search' \
--header 'Authorization: bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
  "pageSize": 1,
  "where": {
    "_and": [
      {
        "_or": [
          {
            "firstName": {
              "_ilike": "%john%"
            }
          },
          {
            "lastName": {
              "_ilike": "%doe%"
            }
          }
        ]
      },
      {
        "active": {
          "_eq": true
        }
      },
      {
        "createdAt": {
          "_gte": "1900-01-01T00:00:00Z"
        }
      },
      {
        "deptId": {
          "_in": [
            1,
            2,
            3
          ]
        }
      }
    ]
  },
  "orderBy": [
    {
      "lastName": "asc"
    },
    {
      "firstName": "asc"
    }
  ]
}'

Retrieve a specific staff member by their unique identifier

This endpoint provides basic staff member information including:

• Staff member identification and PMS reference
• Personal details (name and email)
• Employment status and organizational structure
• Department and office assignments
• Management hierarchy information

Staff Details Include:

• Staff member ID and PMS reference
• Personal information (first name, last name, email)
• Active status indicator
• Department and office identifiers
• Job title and staff type (when available)
• Manager assignment (when applicable)

Business Applications:

• Staff member lookup and verification
• Organizational structure queries
• Basic staff information retrieval
• Department and office staff management

Real Example:

curl --location 'https://{{host}}/v1/staff/123' \
--header 'Authorization: bearer {{token}}' \
--header 'Content-Type: application/json'

Response Example:

{
  "id": 202,
  "pmsRef": "2254",
  "firstName": "Holley",
  "lastName": "Abbott",
  "email": "ena.toy@hotmail.com",
  "active": true,
  "deptId": 8,
  "jobTitle": null,
  "type": null,
  "officeId": 2,
  "staffManagerId": null
}