Eightfold AI · Schema

EmployeeSchema

Talent IntelligenceTalent AcquisitionTalent ManagementAI InterviewingHuman ResourcesWorkforce PlanningAI Agents

Properties

Name Type Description
managerEmail stringnull The email of the manager
location stringnull The location of the employee
awards arraynull Awards listed on employee profile
experiences arraynull Experiences of the employee
customInfo objectnull The custom info captured for the employee by custom fields
employmentDates arraynull The typed lifecycle dates of the employee, keyed by `type`. A write replaces the whole list: send every date that should survive it. Send [] or null to clear all. Omit the field to leave the stored da
systemId stringnull Integration system id for the employee
languages arraynull The employee language proficiencies
pronouns stringnull Preferred pronouns of the employee
externalSystemIds arraynull The employee ids in systems outside the HRIS (payroll and the like). A write replaces the whole list: send every id that should survive it. Send [] or null to clear all. Omit the field to leave the st
terminationRegrettable stringnull Is the exit regrettable?
lastActivityTs integernull The last activity timestamp in seconds
terminationTs integernull The termination timestamp of the employee in seconds
jobCode stringnull The job code of the employee
timezone stringnull Working time zone
preferredFirstName stringnull First name the employee goes by
role stringnull The role of the employee
workplaceModel stringnull Workplace model (office / hybrid / remote)
personalEmail stringnull The personal email of the employee
isContingent booleannull Is contingent
mobility object The mobility of the employee
bu stringnull The Business unit of the employee
temporalFields array Temporal fields of the employee
rmUserGroups arraynull RM user groups associated with the employee
maritalStatus stringnull Marital status of the employee
externalJobId stringnull External job id of the employee
additionalManagers arraynull The additional managers of the employee. The list sent replaces the stored list; send an empty list to clear all, or omit to leave the existing managers unchanged.
associatedRole object The associated role information of the employee
demandExperiences arraynull List of employee's past demand experiences
companyName stringnull The company name of the employee
phone stringnull The phone number of the employee
managerUserId stringnull The user id of the manager in HRIS system
eligibleForTransfer booleannull Is the employee eligible for transfer or not
lastName stringnull Last Name of the employee
employeeType stringnull Type of the employee
middleName stringnull Middle name of the employee
employmentStatus stringnull Current employment status
badges arraynull The badges of the employee
firstName stringnull First Name of the employee
basePay object The base pay of the employee
education arraynull Education of the employee
userId stringnull The userId of the employee
businessEmail stringnull The business email of the employee
lastReviewRating stringnull The last review rating of the employee
employmentBasis stringnull Employment basis (full-time / part-time)
lastUpdatedTs integernull The last updated timestamp of the employee profile
successionPlan object On read: the ids linking this employee to /careerhub/succession_plans, i.e. the plan they are the incumbent of and the plans they are an active successor in. Null when in no plan. Covers position-base
patents arraynull Patents listed on employee profile
bonus object The bonus given to the employee
managerFullname stringnull The full name of the manager
rehireEligibility stringnull Eligible for rehire?
userHighlightedSkills arraynull Skills the employee has highlighted on their Career Hub profile. A write replaces the whole list; an empty list clears it. Only skills already on the profile are returned, in the profile's own spellin
certificates arraynull Certificates of the employee
locationCountry stringnull The location country of the employee
skillAssessmentMetadata object Metadata of the skill assessments
candidateData object candidate data of employee
positionCriticality arraynull The criticality of the position of the employee
email string List of Emails of the employee comma seperated
level stringnull The job level of the employee
terminationType stringnull Termination type (voluntary / involuntary)
employeeId string The unique id of the Employee in the HRIS system
employeeCriticality object The criticality information of the employee
performanceRatings arraynull Performance ratings for the employee
title stringnull The title of the employee
id stringnull Profile id of the Employee in Eightfold
citizenship arraynull Citizenships of the employee, more than one when dual. A write replaces the whole list: send every citizenship that should survive it. Send [] or null to clear all. Omit the field to leave the stored
preferredLastName stringnull Last name the employee goes by
managerContactEmail stringnull The contact email of the manager
hiringTs integernull The hiring timestamp of the employee in seconds
projects arraynull Projects of the employee
roleChangeTs integernull The last role timestamp of the employee in seconds
publications arraynull Publications listed on employee profile
shift stringnull Shift label (morning / evening / night / general)
lob stringnull The lob of the employee
skillDetails arraynull List of profile skills with assessments
salutation stringnull Salutation / title of address
View JSON Schema on GitHub

JSON Schema

eightfold-ai-employee-schema-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/eightfold-ai/main/json-schema/eightfold-ai-employee-schema-schema.json",
  "title": "EmployeeSchema",
  "x-generated": "2026-10-14",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/eightfold-ai-api-server-v2-service-service-openapi.yml#/components/schemas/EmployeeSchema",
  "type": "object",
  "properties": {
    "managerEmail": {
      "type": [
        "string",
        "null"
      ],
      "description": "The email of the manager"
    },
    "location": {
      "type": [
        "string",
        "null"
      ],
      "description": "The location of the employee"
    },
    "awards": {
      "readOnly": true,
      "description": "Awards listed on employee profile",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/Award"
      }
    },
    "experiences": {
      "readOnly": true,
      "description": "Experiences of the employee",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/ExperienceSchema"
      }
    },
    "customInfo": {
      "type": [
        "object",
        "null"
      ],
      "description": "The custom info captured for the employee by custom fields"
    },
    "employmentDates": {
      "description": "The typed lifecycle dates of the employee, keyed by `type`. A write replaces the whole list: send every date that should survive it. Send [] or null to clear all. Omit the field to leave the stored dates untouched.",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/EmployeeEmploymentDate"
      }
    },
    "systemId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Integration system id for the employee"
    },
    "languages": {
      "description": "The employee language proficiencies",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/EmployeeLanguageProficiency"
      }
    },
    "pronouns": {
      "type": [
        "string",
        "null"
      ],
      "description": "Preferred pronouns of the employee"
    },
    "externalSystemIds": {
      "description": "The employee ids in systems outside the HRIS (payroll and the like). A write replaces the whole list: send every id that should survive it. Send [] or null to clear all. Omit the field to leave the stored ids untouched.",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/EmployeeExternalSystemId"
      }
    },
    "terminationRegrettable": {
      "type": [
        "string",
        "null"
      ],
      "description": "Is the exit regrettable?"
    },
    "lastActivityTs": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int32",
      "description": "The last activity timestamp in seconds"
    },
    "terminationTs": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int32",
      "description": "The termination timestamp of the employee in seconds"
    },
    "jobCode": {
      "type": [
        "string",
        "null"
      ],
      "description": "The job code of the employee"
    },
    "timezone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Working time zone"
    },
    "preferredFirstName": {
      "type": [
        "string",
        "null"
      ],
      "description": "First name the employee goes by"
    },
    "role": {
      "type": [
        "string",
        "null"
      ],
      "description": "The role of the employee"
    },
    "workplaceModel": {
      "type": [
        "string",
        "null"
      ],
      "description": "Workplace model (office / hybrid / remote)"
    },
    "personalEmail": {
      "type": [
        "string",
        "null"
      ],
      "description": "The personal email of the employee"
    },
    "isContingent": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Is contingent"
    },
    "mobility": {
      "nullable": true,
      "description": "The mobility of the employee",
      "allOf": [
        {
          "$ref": "#/$defs/EmployeeMobility"
        }
      ]
    },
    "bu": {
      "type": [
        "string",
        "null"
      ],
      "description": "The Business unit of the employee"
    },
    "temporalFields": {
      "description": "Temporal fields of the employee",
      "type": "array",
      "items": {
        "$ref": "#/$defs/TemporalField"
      }
    },
    "rmUserGroups": {
      "description": "RM user groups associated with the employee",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/RmUserGroup"
      }
    },
    "maritalStatus": {
      "type": [
        "string",
        "null"
      ],
      "description": "Marital status of the employee"
    },
    "externalJobId": {
      "type": [
        "string",
        "null"
      ],
      "description": "External job id of the employee"
    },
    "additionalManagers": {
      "description": "The additional managers of the employee. The list sent replaces the stored list; send an empty list to clear all, or omit to leave the existing managers unchanged.",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/AdditionalManager"
      }
    },
    "associatedRole": {
      "readOnly": true,
      "nullable": true,
      "description": "The associated role information of the employee",
      "allOf": [
        {
          "$ref": "#/$defs/EmployeeAssociatedRole"
        }
      ]
    },
    "demandExperiences": {
      "readOnly": true,
      "description": "List of employee's past demand experiences",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/ExperienceSchema"
      }
    },
    "companyName": {
      "type": [
        "string",
        "null"
      ],
      "description": "The company name of the employee"
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "The phone number of the employee"
    },
    "managerUserId": {
      "type": [
        "string",
        "null"
      ],
      "description": "The user id of the manager in HRIS system"
    },
    "eligibleForTransfer": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Is the employee eligible for transfer or not"
    },
    "lastName": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last Name of the employee"
    },
    "employeeType": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type of the employee"
    },
    "middleName": {
      "type": [
        "string",
        "null"
      ],
      "description": "Middle name of the employee"
    },
    "employmentStatus": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current employment status"
    },
    "badges": {
      "description": "The badges of the employee",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/EmployeeBadge"
      }
    },
    "firstName": {
      "type": [
        "string",
        "null"
      ],
      "description": "First Name of the employee"
    },
    "basePay": {
      "nullable": true,
      "description": "The base pay of the employee",
      "allOf": [
        {
          "$ref": "#/$defs/Pay"
        }
      ]
    },
    "education": {
      "readOnly": true,
      "description": "Education of the employee",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/CandidateEducation"
      }
    },
    "userId": {
      "type": [
        "string",
        "null"
      ],
      "description": "The userId of the employee"
    },
    "businessEmail": {
      "type": [
        "string",
        "null"
      ],
      "description": "The business email of the employee"
    },
    "lastReviewRating": {
      "type": [
        "string",
        "null"
      ],
      "description": "The last review rating of the employee"
    },
    "employmentBasis": {
      "type": [
        "string",
        "null"
      ],
      "description": "Employment basis (full-time / part-time)"
    },
    "lastUpdatedTs": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int32",
      "readOnly": true,
      "description": "The last updated timestamp of the employee profile"
    },
    "successionPlan": {
      "nullable": true,
      "description": "On read: the ids linking this employee to /careerhub/succession_plans, i.e. the plan they are the incumbent of and the plans they are an active successor in. Null when in no plan. Covers position-based succession plans; tenants still on the legacy profile-based model mostly get null. On write: the HRIS succession plan for this employee.",
      "allOf": [
        {
          "$ref": "#/$defs/EmployeeSuccessionPlanLinks"
        }
      ]
    },
    "patents": {
      "readOnly": true,
      "description": "Patents listed on employee profile",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/Patent"
      }
    },
    "bonus": {
      "nullable": true,
      "description": "The bonus given to the employee",
      "allOf": [
        {
          "$ref": "#/$defs/Pay"
        }
      ]
    },
    "managerFullname": {
      "type": [
        "string",
        "null"
      ],
      "description": "The full name of the manager"
    },
    "rehireEligibility": {
      "type": [
        "string",
        "null"
      ],
      "description": "Eligible for rehire?"
    },
    "userHighlightedSkills": {
      "type": [
        "array",
        "null"
      ],
      "description": "Skills the employee has highlighted on their Career Hub profile. A write replaces the whole list; an empty list clears it. Only skills already on the profile are returned, in the profile's own spelling.",
      "items": {
        "type": "string"
      }
    },
    "certificates": {
      "readOnly": true,
      "description": "Certificates of the employee",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/CertificateSchema"
      }
    },
    "locationCountry": {
      "type": [
        "string",
        "null"
      ],
      "description": "The location country of the employee"
    },
    "skillAssessmentMetadata": {
      "readOnly": true,
      "nullable": true,
      "description": "Metadata of the skill assessments",
      "allOf": [
        {
          "$ref": "#/$defs/SkillAssessmentMetadata"
        }
      ]
    },
    "candidateData": {
      "nullable": true,
      "description": "candidate data of employee",
      "allOf": [
        {
          "$ref": "#/$defs/EmployeeCandidateData"
        }
      ]
    },
    "positionCriticality": {
      "type": [
        "array",
        "null"
      ],
      "description": "The criticality of the position of the employee",
      "items": {
        "type": "string"
      }
    },
    "email": {
      "type": "string",
      "description": "List of Emails of the employee comma seperated"
    },
    "level": {
      "type": [
        "string",
        "null"
      ],
      "description": "The job level of the employee"
    },
    "terminationType": {
      "type": [
        "string",
        "null"
      ],
      "description": "Termination type (voluntary / involuntary)"
    },
    "employeeId": {
      "type": "string",
      "description": "The unique id of the Employee in the HRIS system"
    },
    "employeeCriticality": {
      "nullable": true,
      "description": "The criticality information of the employee",
      "allOf": [
        {
          "$ref": "#/$defs/EmployeeCriticality"
        }
      ]
    },
    "performanceRatings": {
      "description": "Performance ratings for the employee",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/EmployeePerformanceRating"
      }
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "The title of the employee"
    },
    "id": {
      "type": [
        "string",
        "null"
      ],
      "readOnly": true,
      "description": "Profile id of the Employee in Eightfold"
    },
    "citizenship": {
      "type": [
        "array",
        "null"
      ],
      "description": "Citizenships of the employee, more than one when dual. A write replaces the whole list: send every citizenship that should survive it. Send [] or null to clear all. Omit the field to leave the stored citizenships untouched.",
      "items": {
        "type": "string"
      }
    },
    "preferredLastName": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last name the employee goes by"
    },
    "managerContactEmail": {
      "type": [
        "string",
        "null"
      ],
      "description": "The contact email of the manager"
    },
    "hiringTs": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int32",
      "description": "The hiring timestamp of the employee in seconds"
    },
    "projects": {
      "readOnly": true,
      "description": "Projects of the employee",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/Project"
      }
    },
    "roleChangeTs": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int32",
      "description": "The last role timestamp of the employee in seconds"
    },
    "publications": {
      "readOnly": true,
      "description": "Publications listed on employee profile",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/Publication"
      }
    },
    "shift": {
      "type": [
        "string",
        "null"
      ],
      "description": "Shift label (morning / evening / night / general)"
    },
    "lob": {
      "type": [
        "string",
        "null"
      ],
      "description": "The lob of the employee"
    },
    "skillDetails": {
      "readOnly": true,
      "description": "List of profile skills with assessments",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/ProfileSkillSchema"
      }
    },
    "salutation": {
      "type": [
        "string",
        "null"
      ],
      "description": "Salutation / title of address"
    }
  },
  "required": [
    "email",
    "employeeId"
  ],
  "$defs": {
    "ATSScoreCardAttribute": {
      "type": "object",
      "properties": {
        "rating": {
          "type": [
            "string",
            "null"
          ],
          "description": "Rating. Valid inputs: strong_yes, yes, mixed, no, strong_no"
        },
        "answer": {
          "type": [
            "string",
            "null"
          ],
          "description": "Answer"
        },
        "note": {
          "type": [
            "string",
            "null"
          ],
          "description": "Note"
        },
        "question": {
          "type": [
            "string",
            "null"
          ],
          "description": "Question"
        },
        "rating_label": {
          "type": [
            "string",
            "null"
          ],
          "description": "Rating label"
        }
      }
    },
    "ATSSkillDetail": {
      "type": "object",
      "properties": {
        "skillGroups": {
          "description": "Skill groups",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/ATSSkillGroup"
          }
        },
        "proficiency": {
          "type": [
            "string",
            "null"
          ],
          "description": "Proficiency. Note: proficiency must be specified only for each skill group when skill groups are present"
        },
        "evaluationTimestamp": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "Evaluation timestamp"
        },
        "dataSource": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data source of the skill"
        },
        "skill": {
          "type": [
            "string",
            "null"
          ],
          "description": "Skill"
        }
      }
    },
    "ATSSkillGroup": {
      "type": "object",
      "properties": {
        "proficiency": {
          "type": [
            "string",
            "null"
          ],
          "description": "Proficiency"
        },
        "skillGroup": {
          "type": [
            "string",
            "null"
          ],
          "description": "Skill Group"
        }
      }
    },
    "AdditionalManager": {
      "type": "object",
      "properties": {
        "capacityManagerEmail": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": true,
          "description": "The email of the capacity manager"
        },
        "employeeId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Employee id of the additional manager in the HRIS system"
        },
        "type": {
          "type": [
            "string",
            "null"
          ],
          "description": "Type of the additional manager (e.g. capacity)"
        },
        "email": {
          "type": [
            "string",
            "null"
          ],
          "description": "Email of the additional manager"
        }
      }
    },
    "AtsApplicationSchema": {
      "type": "object",
      "properties": {
        "locationCountry": {
          "type": [
            "string",
            "null"
          ],
          "description": "location country of an application"
        },
        "reason": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 5000,
          "description": "reason for an application"
        },
        "location": {
          "type": [
            "string",
            "null"
          ],
          "description": "location of an application"
        },
        "visaStatuses": {
          "type": [
            "array",
            "null"
          ],
          "description": "list of visa status",
          "items": {
            "type": "string"
          }
        },
        "veteranStatusStr": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": true,
          "description": "String value for veteran status of the applicant"
        },
        "jobs": {
          "description": "Jobs related to an application.",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/Jobs"
          }
        },
        "hiredTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "hired timestamp of an applicant"
        },
        "lastModifiedTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "last modified timestamp of an application"
        },
        "customInfo": {
          "type": [
            "object",
            "null"
          ],
          "description": "custom info for an application"
        },
        "note": {
          "nullable": true,
          "description": "ats notes for an application",
          "allOf": [
            {
              "$ref": "#/$defs/AtsNoteSchema"
            }
          ]
        },
        "systemId": {
          "type": [
            "string",
            "null"
          ],
          "description": "system id of an application"
        },
        "creditor": {
          "type": [
            "string",
            "null"
          ],
          "description": "creditor of an application"
        },
        "candidateId": {
          "type": [
            "string",
            "null"
          ],
          "description": "candidate id of an applicant"
        },
        "rejectedTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "rejected timestamp of an applicant"
        },
        "veteranStatus": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Boolean value for veteran status of the applicant"
        },
        "applicationTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "application timestamp"
        },
        "pastStages": {
          "description": "past stages of an application",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/AtsStage"
          }
        },
        "sourceName": {
          "type": [
            "string",
            "null"
          ],
          "description": "source name of an application"
        },
        "isProspect": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "is prospective applicant"
        },
        "scorecards": {
          "description": "scorecards for an application",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/AtsScorecard"
          }
        },
        "jobSystemId": {
          "type": [
            "string",
            "null"
          ],
          "description": "job system id for an application"
        },
        "disabilityStatus": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "disability status of an applicant"
        },
        "currentStage": {
          "nullable": true,
          "description": "current stage of an application",
          "allOf": [
            {
              "$ref": "#/$defs/AtsStage"
            }
          ]
        },
        "status": {
          "type": [
            "string",
            "null"
          ],
          "description": "Status of application.Valid inputs: active, hired, rejected, converted, withdrawn"
        },
        "races": {
          "type": [
            "array",
            "null"
          ],
          "description": "list of races of an applicant",
          "items": {
            "type": "string"
          }
        },
        "sourceType": {
          "type": [
            "string",
            "null"
          ],
          "description": "source type of an application"
        },
        "gender": {
          "type": [
            "string",
            "null"
          ],
          "description": "gender of an applicant"
        },
        "questions": {
          "description": "questions",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/AtsQuestionAnswer"
          }
        },
        "rejectedBy": {
          "type": [
            "string",
            "null"
          ],
          "description": "applicant rejected by"
        },
        "disabilityStatusStr": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": true,
          "description": "disability status of an applicant"
        },
        "applicationId": {
          "type": "string",
          "description": "application id"
        }
      },
      "required": [
        "applicationId",
        "applicationTs",
        "candidateId",
        "lastModifiedTs"
      ]
    },
    "AtsAttachmentApplicationMetadataSchema": {
      "type": "object",
      "properties": {
        "applicationId": {
          "type": "string",
          "description": "application id for an attachment"
        }
      },
      "required": [
        "applicationId"
      ]
    },
    "AtsAttachmentSchema": {
      "type": "object",
      "properties": {
        "isBase64": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Denotes if the attachment base64 encoded"
        },
        "fileName": {
          "type": "string",
          "description": "File name of the attachment"
        },
        "lastModifiedTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "Last Modified timestamp of the attachment"
        },
        "applicationMetadata": {
          "description": "application_metadata",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/AtsAttachmentApplicationMetadataSchema"
          }
        },
        "attachmentContent": {
          "type": [
            "string",
            "null"
          ],
          "description": "Content of the attachment"
        },
        "attachmentId": {
          "type": "string",
          "description": "Attachment id of the attachment"
        },
        "attachmentType": {
          "type": [
            "string",
            "null"
          ],
          "description": "Attachment type. Valid inputs: resume, others, photo, cover_letter"
        }
      },
      "required": [
        "attachmentContent",
        "attachmentId",
        "attachmentType",
        "fileName"
      ]
    },
    "AtsCertificationSchema": {
      "type": "object",
      "properties": {
        "locationCountry": {
          "type": [
            "string",
            "null"
          ],
          "description": "Country where certification was issued"
        },
        "verificationStatus": {
          "type": [
            "string",
            "null"
          ],
          "description": "verification status of a certification"
        },
        "licenseNo": {
          "type": [
            "string",
            "null"
          ],
          "description": "License number of a certification"
        },
        "skills": {
          "type": [
            "array",
            "null"
          ],
          "description": "Skills associated with the certification",
          "items": {
            "type": "string"
          }
        },
        "validFromTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "validtion from timestamp of a certification"
        },
        "comments": {
          "type": [
            "string",
            "null"
          ],
          "description": "Comments on the certification"
        },
        "allText": {
          "type": [
            "string",
            "null"
          ],
          "description": "All text associated with the certification"
        },
        "endTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "ending timestamp of a certification"
        },
        "verificationBy": {
          "type": [
            "string",
            "null"
          ],
          "description": "email of the verifier"
        },
        "certificateName": {
          "type": [
            "string",
            "null"
          ],
          "description": "certificate name of a certification"
        },
        "verificationTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "verification timestamp"
        },
        "status": {
          "type": [
            "string",
            "null"
          ],
          "description": "Status of the certification"
        },
        "certificateType": {
          "type": [
            "string",
            "null"
          ],
          "description": "Type of the certification"
        },
        "proficiency": {
          "type": [
            "string",
            "null"
          ],
          "description": "proficiency of a certification"
        },
        "validToTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "validation till timestamp of a certification"
        },
        "attachmentIds": {
          "type": [
            "array",
            "null"
          ],
          "description": "List of attachment ids of a certification",
          "items": {
            "type": "string"
          }
        },
        "startTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "starting timestamp of a certification"
        },
        "certificateExternalId": {
          "type": [
            "string",
            "null"
          ],
          "description": "external id for the type of certification"
        },
        "locationState": {
          "type": [
            "string",
            "null"
          ],
          "description": "State where certification was issued"
        },
        "issuingAuthority": {
          "type": [
            "string",
            "null"
          ],
          "description": "issuing authority of a certification"
        },
        "description": {
          "type": [
            "string",
            "null"
          ],
          "description": "Description of the certification"
        }
      },
      "required": [
        "certificateName"
      ]
    },
    "AtsContent": {
      "type": "object",
      "properties": {
        "extension": {
          "type": [
            "string",
            "null"
          ],
          "description": "extension"
        },
        "content": {
          "type": [
            "string",
            "null"
          ],
          "description": "content"
        },
        "isBase64": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "is base 64 encoded?"
        }
      }
    },
    "AtsEducationSchema": {
      "type": "object",
      "properties": {
        "endTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "ending timestamp"
        },
        "verificationStatus": {
          "type": [
            "string",
            "null"
          ],
          "description": "verification status of the education details"
        },
        "degreeExternalId": {
          "type": [
            "string",
            "null"
          ],
          "description": "external id of the degree"
        },
        "attachmentIds": {
          "type": [
            "array",
            "null"
          ],
          "description": "List of attachment ids of the education",
          "items": {
            "type": "string"
          }
        },
        "startTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "starting timestamp of education"
        },
        "degree": {
          "type": [
            "string",
            "null"
          ],
          "description": "degree"
        },
        "major": {
          "type": [
            "string",
            "null"
          ],
          "description": "major"
        },
        "verificationBy": {
          "type": [
            "string",
            "null"
          ],
          "description": "email of the verifier"
        },
        "location": {
          "type": [
            "string",
            "null"
          ],
          "description": "location"
        },
        "isCurrent": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "is current education"
        },
        "schoolExternalId": {
          "type": [
            "string",
            "null"
          ],
          "description": "external id of the school"
        },
        "majorExternalId": {
          "type": [
            "string",
            "null"
          ],
          "description": "external id of the major"
        },
        "verificationTs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "verification timestamp"
        },
        "school": {
          "type": [
            "string",
            "null"
          ],
          "descrip

# --- truncated at 32 KB (87 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/eightfold-ai/refs/heads/main/json-schema/eightfold-ai-employee-schema-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/eightfold-ai-employee-schema"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.