Truto · Schema

Employee

A normalized employee record returned by the Truto Unified HRIS API, representing a unified view of employee data across 41 HRIS providers.

Unified APIIntegration PlatformHRISATSCRMEmbedded IntegrationsMCPAI AgentsSaaS

Properties

Name Type Description
id string Unified employee identifier assigned by Truto.
remoteId string Employee identifier in the source HRIS system.
firstName string Employee first name.
lastName string Employee last name.
displayName string Preferred display name.
email string Work email address.
personalEmail string Personal email address.
phone string Work phone number.
status string Current employment status.
employmentType string Type of employment.
jobTitle string Current job title.
departmentId string Identifier of the employee's department group.
managerId string Identifier of the employee's manager.
hireDate string Date the employee was hired.
terminationDate string Date of termination, if applicable.
location string Work location (office or remote).
avatar string URL to employee profile photo.
createdAt string Record creation timestamp.
updatedAt string Record last updated timestamp.
View JSON Schema on GitHub

JSON Schema

truto-employee-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.truto.one/schemas/employee",
  "title": "Employee",
  "description": "A normalized employee record returned by the Truto Unified HRIS API, representing a unified view of employee data across 41 HRIS providers.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unified employee identifier assigned by Truto."
    },
    "remoteId": {
      "type": "string",
      "description": "Employee identifier in the source HRIS system."
    },
    "firstName": {
      "type": "string",
      "description": "Employee first name."
    },
    "lastName": {
      "type": "string",
      "description": "Employee last name."
    },
    "displayName": {
      "type": "string",
      "description": "Preferred display name."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Work email address."
    },
    "personalEmail": {
      "type": "string",
      "format": "email",
      "description": "Personal email address."
    },
    "phone": {
      "type": "string",
      "description": "Work phone number."
    },
    "status": {
      "type": "string",
      "enum": ["active", "inactive", "terminated"],
      "description": "Current employment status."
    },
    "employmentType": {
      "type": "string",
      "enum": ["full_time", "part_time", "contractor", "intern", "other"],
      "description": "Type of employment."
    },
    "jobTitle": {
      "type": "string",
      "description": "Current job title."
    },
    "departmentId": {
      "type": "string",
      "description": "Identifier of the employee's department group."
    },
    "managerId": {
      "type": "string",
      "description": "Identifier of the employee's manager."
    },
    "hireDate": {
      "type": "string",
      "format": "date",
      "description": "Date the employee was hired."
    },
    "terminationDate": {
      "type": "string",
      "format": "date",
      "description": "Date of termination, if applicable."
    },
    "location": {
      "type": "string",
      "description": "Work location (office or remote)."
    },
    "avatar": {
      "type": "string",
      "format": "uri",
      "description": "URL to employee profile photo."
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "Record creation timestamp."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Record last updated timestamp."
    }
  },
  "required": ["id", "remoteId", "status"]
}