批量查询员工信息

通过员工 ID 、个人信息 ID、工作邮箱等筛选项批量查询员工的工作信息、个人信息。

Tip: 该接口会按照应用拥有的「员工数据」的权限范围返回数据，请确定在「开发者后台 - 权限管理 - 数据权限」中有申请「员工资源」权限范围

• 每次最多传 100 个员工 ID，若需单次查询全量员工，可使用接口【搜索员工信息】
• 由于人员全数据关联较多业务数据和计算数据等，更新后存在2-5s短暂延时，建议数据更新动作完成后稍等几秒进行最新数据查询请求
• 当员工未完成入职时，该接口将无法查询到该员工数据，如【待入职】【撤销入职】【删除雇佣】等情况
• 部分计算字段是在凌晨零点进行计算，建议不要在零点时间段进行查询

Warning: - 字段未返回请检查：字段权限、用户该字段有值，以及飞书人事档案配置中字段是否启用

• 基于 id_type 类型字段（如 employment_id），在部分转换失败（ID映射不存在）的场景会返回 lark_id，无法区分值是否为对应 id_type。新增相关 id_v2 的字段，在转换失败时返回空值，用于区分是否转换成功；正常情况下两个字段的值是没有区别的，建议使用 id_v2 的字段
• 在人事系统开启【复用工号】后，存在一个工号对应多个员工的情况，请勿依赖工号做唯一性检查

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/employees/batch_get
HTTP Method	POST
接口频率限制	100 次/分钟
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	corehr:employee:read 获取员工信息 corehr:employee:write 读写员工信息
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 corehr:contract.period:read 获取合同期限信息 corehr:employee.all_bp:read 查看员工的全部 BP 信息 corehr:employee.bp:read 查看员工的部分 BP 信息 corehr:employment.assignment:read 获取员工外派信息 corehr:employment.custom_field:read 获取雇佣信息自定义字段信息 corehr:employment.custom_org_field:read 获取员工的自定义组织信息 corehr:employment.custom_org_field:write 读写员工的自定义组织信息 corehr:employment.job:read 获取员工的职务信息 corehr:employment.job_level:read 获取职务级别信息 corehr:employment.offboarding_reason:read 获取员工离职原因 corehr:employment.pathway:read 获取员工通道信息 corehr:employment.pathway:write 读写员工通道 corehr:employment.pay_group:read 获取薪资组信息 corehr:employment.position:read 获取员工的岗位信息 corehr:employment.position:write 读写员工的岗位信息 corehr:job.job_level:read 获取职务中的职级信息 corehr:person.address:read 读取个人地址信息 corehr:person.address:write 读写个人地址信息 corehr:person.bank_account:read 获取银行账号列表信息 corehr:person.bank_account:write 读写银行账号信息 corehr:person.born_country_region:read 获取出生国家/地区信息 corehr:person.custom_field:read 获取个人信息自定义字段信息 corehr:person.date_entered_workforce:read 获取参加工作日期 corehr:person.date_entered_workforce:write 读写参加工作日期 corehr:person.date_of_birth:read 获取生日信息 corehr:person.date_of_birth:write 读写生日信息 corehr:person.dependent:read 获取家庭成员信息 corehr:person.dependent:write 读写家庭成员信息 corehr:person.education:read 获取教育经历信息 corehr:person.education:write 读写教育经历信息 corehr:person.email:read 获取个人邮箱信息 corehr:person.email:write 读写个人邮箱信息 corehr:person.emergency_contact:read 获取紧急联系人信息 corehr:person.emergency_contact:write 读写紧急联系人信息 corehr:person.entry_leave_time:read 获取出入境日期信息 corehr:person.gender:read 获取性别信息 corehr:person.gender:write 读写性别信息 corehr:person.hukou:read 获取户口信息 corehr:person.hukou:write 读写户口信息 corehr:person.is_disabled:read 获取残疾信息 corehr:person.is_old_alone:read 获取孤老信息 corehr:person.legal_name:read 获取法定姓名信息 corehr:person.legal_name:write 读写法定姓名信息 corehr:person.marital_status:read 获取婚姻状况信息 corehr:person.marital_status:write 读写婚姻状况信息 corehr:person.martyr_family:read 获取烈属信息 corehr:person.martyr_family:write 读写烈属信息 corehr:person.national_id:read 获取证件信息 corehr:person.national_id:write 读写证件信息 corehr:person.nationality:read 获取国籍信息 corehr:person.native_region:read 获取籍贯信息 corehr:person.native_region:write 读写籍贯信息 corehr:person.personal_profile:read 获取个人资料信息 corehr:person.personal_profile:write 读写个人资料信息 corehr:person.phone:read 获取个人手机号信息 corehr:person.phone:write 读写个人手机号信息 corehr:person.political_affiliation:read 获取政治面貌信息 corehr:person.race:read 获取民族/种族信息 corehr:person.religion:read 查看宗教信仰信息 corehr:person.resident_tax:read 获取居民身份信息 corehr:person.resident_tax:write 读写居民身份信息 corehr:person.resident_tax_custom_field:read 获取居民身份自定义字段信息 corehr:person.resident_tax_custom_field:write 读写居民身份自定义字段信息 corehr:person.work_experience:read 获取工作履历信息 corehr:person.work_experience:write 读写工作履历信息 contact:user.employee_id:readonly 获取用户 user ID corehr:employment.assignment_pay_group:read 获取员工所属外派薪资组 corehr:person.born_country_region:write 读写出生国家/地区信息 corehr:person.nationality:write 读写国籍信息 corehr:person.entry_leave_time:write 读写出入境日期信息 corehr:employment.job_grade:read 获取职等信息 corehr:person.custom_field:write 读写个人信息中的自定义字段信息 corehr:employment.job_grade:write 读写职等信息 corehr:employment.seniority_adjust_information:read 获取员工司龄调整信息 corehr:employment.seniority_adjust_information:write 读写员工司龄调整信息 corehr:person.is_disabled:write 读写残疾信息 corehr:person.political_affiliation:write 读写个人政治面貌信息 corehr:employment.contract_type:read 获取员工合同类型 corehr:person.is_old_alone:write 读写孤老信息 corehr:person.religion:write 读写宗教信仰信息 corehr:job_data.compensation_type:read 获取薪资类型 corehr:job_data.service_company:read 获取任职公司 corehr:job_data.work_shift:read 获取排班信息 corehr:employment.job_level:write 读写员工的职务级别信息 corehr:contract.period:write 读写合同期限信息 corehr:employment.archive_cpst_plan:read 获取员工薪资方案

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	必填	描述
user_id_type	string	否	用户 ID 类型 示例值：open_id 可选值有： - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_corehr_id: 以飞书人事的 ID 来识别用户 默认值：open_id 当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
department_id_type	string	否	此次调用中使用的部门 ID 类型 示例值：open_department_id 可选值有： - open_department_id: 以 open_department_id 来标识部门 - department_id: 以 department_id 来标识部门 - people_corehr_department_id: 以 people_corehr_department_id 来标识部门 默认值：open_department_id

请求体

名称	类型	必填	描述
fields	string\[\]	否	需要查询的字段列表 - 参考【字段下钻】 - 为空时仅返回 employment_id 示例值：["person_info.phone_number"] 数据校验规则： - 最大长度：100
employment_ids	string\[\]	否	雇佣 ID 列表 - 以下请求参数中「employment_ids」，「person_ids」，「work_emails」不得均为空 - 请根据需求选择一种模式进行查询，若单次请求中多个请求参数有值，按照【employment_ids > person_ids > work_emails】的顺序只识别第一个有值的请求参数 - ID 类型需要与 user_id_type 保持一致。 - 在【创建雇佣】时返回的 ID。 示例值：["7140964208476371111"] 数据校验规则： - 长度范围：0 ～ 100
person_ids	string\[\]	否	个人信息 ID 列表，employment_ids参数有值时该参数不生效。 - 在【创建个人信息】时返回的 ID。 示例值：["7051837122449458732"] 数据校验规则： - 长度范围：0 ～ 100
work_emails	string\[\]	否	主工作邮箱列表，「employment_ids」，「person_ids」参数有值时该参数不生效。 示例值：["zhangsan@example.feishu.cn"] 数据校验规则： - 长度范围：0 ～ 100

请求体示例

{
    "fields": [
        "person_info.phone_number"
    ],
    "employment_ids": [
        "7140964208476371111"
    ],
    "person_ids": [
        "7051837122449458732"
    ],
    "work_emails": [
        "zhangsan@example.feishu.cn"
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	employee\[\]	查询的雇佣信息
└ employment_id	string	雇佣 ID，类型与user_id_type 一致
└ employment_id_v2	string	雇佣 ID - 类型与 user_id_type 一致 - 正常情况下，与 employment_id 是一致的，仅转换失败时会返回空值
└ ats_application_id	string	招聘投递 ID ，详细信息可以通过获取投递信息接口查询获得
└ prehire_id	string	待入职 ID，详细信息可以通过【查询单个待入职】获取
└ employee_number	string	工号
└ employee_type_id	string	人员类型 ID，详细信息可通过查询单个人员类型接口获得
└ employee_subtype_id	string	人员子类型 ID - 功能灰度中，如有需求请联系技术支持
└ department_id	string	部门 ID - 可通过批量查询部门V2 或者搜索部门信息 获取详情 - 类型与 department_id_type 一致
└ department_id_v2	string	部门 ID，当按照department_id_type转换失败时返回为空值 - 可通过批量查询部门V2 或者搜索部门信息 获取详情 - 类型与 department_id_type 一致
└ job_level_id	string	职级 ID，详细信息可通过查询单个职级接口获得 字段权限要求（满足任一）： corehr:employment.job_level:read 获取职务级别信息 corehr:employment.job_level:write 读写员工的职务级别信息
└ job_level	employee.job_level	职级 字段权限要求（满足任一）： corehr:employment.job_level:read 获取职务级别信息 corehr:employment.job_level:write 读写员工的职务级别信息
└ id	string	职级 ID，可通过【查询单个职级】获取详细信息 - 与 job_level_id 值相同
└ level_order	int	职级数值
└ code	string	编码
└ name	i18n\[\]	名称
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ description	i18n\[\]	描述
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ active	boolean	启用
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ pathway_id	string	通道 ID 字段权限要求（满足任一）： corehr:employment.pathway:read 获取员工通道信息 corehr:employment.pathway:write 读写员工通道
└ pathway	employee.pathway	通道 字段权限要求（满足任一）： corehr:employment.pathway:read 获取员工通道信息 corehr:employment.pathway:write 读写员工通道
└ id	string	通道 ID
└ code	string	编码
└ name	i18n\[\]	名称
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ description	i18n\[\]	描述
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ active	boolean	启用
└ custom_fields	custom_field_data\[\]	自定义字段
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ job_grade_id	string	职等 ID，通过 【查询职等】获取详细信息 字段权限要求（满足任一）： corehr:employment.job_grade:read 获取职等信息 corehr:employment.job_grade:write 读写职等信息
└ work_location_id	string	工作地点 ID，详细信息可通过查询单个地点接口获得
└ job_family_id	string	序列 ID，详细信息可通过查询单个序列接口获得
└ job_family	employee.job_family	序列
└ id	string	序列 ID，可通过【查询单个序列】获取详细信息 - 与 job_family_id 值相同
└ name	i18n\[\]	名称
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ active	boolean	是否启用
└ parent_id	string	上级序列，可通过【查询单个序列】获取详细信息
└ effective_time	string	当前序列版本的生效时间
└ expiration_time	string	当前序列版本的失效时间
└ code	string	编码
└ custom_fields	custom_field_data\[\]	自定义字段 - 当前为预留字段，返回值为空。具体支持的对象请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ position_id	string	岗位 ID - 功能灰度中，有需要请联系技术支持 字段权限要求（满足任一）： corehr:employment.position:read 获取员工的岗位信息 corehr:employment.position:write 读写员工的岗位信息
└ position	position	岗位 - 功能灰度中，有需要请联系技术支持 字段权限要求（满足任一）： corehr:employment.position:read 获取员工的岗位信息 corehr:employment.position:write 读写员工的岗位信息
└ position_id	string	岗位 ID，详细信息可通过【查询岗位】接口获得
└ code	string	编码
└ names	i18n\[\]	名称
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ descriptions	i18n\[\]	描述
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ active	boolean	状态
└ job_id	string	职务 ID，详细信息可通过查询单个职务（V2）接口获得 字段权限要求（满足任一）： corehr:employment.job:read 获取员工的职务信息 corehr:employment.job_level:read 获取职务级别信息 corehr:employment.job_level:write 读写员工的职务级别信息
└ job	job	职务 字段权限要求（满足任一）： corehr:employment.job:read 获取员工的职务信息 corehr:employment.job_level:read 获取职务级别信息 corehr:employment.job_level:write 读写员工的职务级别信息
└ id	string	实体在CoreHR内部的唯一键
└ code	string	编码
└ name	i18n\[\]	名称
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ description	i18n\[\]	描述
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ active	boolean	启用
└ job_title	i18n\[\]	职务头衔
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ pathway_id	string	通道ID
└ job_family_id_list	string\[\]	序列
└ job_level_id_list	string\[\]	职级 字段权限要求： corehr:job.job_level:read 获取职务中的职级信息
└ working_hours_type_id	string	工时制度，可通过【查询单个工时制度】查询详细信息
└ effective_time	string	职务当前版本的生效时间
└ expiration_time	string	职务当前版本的失效时间
└ custom_fields	object_field_data\[\]	自定义字段 - 当前为预留字段，返回值为空。具体支持的对象请参考【自定义字段说明】
└ field_name	string	字段名
└ value	string	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
└ company_id	string	所属公司 ID，详细信息可通过查询单个公司接口获得 - 当前生效的合同中的公司
└ working_hours_type_id	string	工时制度 ID，详细信息可通过查询单个工时制度接口获得
└ tenure	string	司龄
└ seniority_date	string	司龄起算日期
└ effective_date	string	当前雇佣记录的入职日期
└ primary_employment	boolean	是否是主雇佣信息
└ probation_period	int	试用期时长（月）
└ on_probation	boolean	是否在试用期中
└ probation_end_date	string	试用期结束日期（实际结束日期）
└ direct_manager_id	string	直接上级的雇佣 ID，可通过【批量查询员工信息】 或 【搜索员工信息】获取详细信息；类型与 user_id_type 一致
└ dotted_line_manager_id	string	虚线上级的雇佣 ID，可通过【批量查询员工信息】 或 【搜索员工信息】获取详细信息；类型与 user_id_type 一致
└ direct_manager_id_v2	string	直接上级的雇佣 ID - 类型与 user_id_type 一致，转换失败返回空值
└ dotted_line_manager_id_v2	string	虚线上级的雇佣 ID - 类型与 user_id_type 一致，转换失败返回空值
└ employment_type	enum	雇佣类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：employment - custom_api_name：employment_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ employment_status	enum	雇佣状态 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：employment - custom_api_name：employment_status
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ expiration_date	string	离职日期，即员工的最后一个工作日，最后一个工作日时员工的雇佣状态仍为“在职”，次日凌晨将更改为“离职”
└ reason_for_offboarding	enum	离职原因 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：employment - custom_api_name：reason_for_offboarding 字段权限要求： corehr:employment.offboarding_reason:read 获取员工离职原因
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ email_address	string	工作邮箱地址 - 计算字段，取自 work_email_list - email_usage：work - is_primary： true
└ work_email_list	work_email\[\]	工作邮箱列表
└ email	string	邮箱地址
└ email_usage	enum	邮箱用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: email - custom_api_name：email_usage
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ cost_center_list	job_data_cost_center\[\]	成本中心列表
└ cost_center_id	string	成本中心 ID，可以通过搜索成本中心信息接口获取对应的成本中心信息
└ rate	int	分摊比例(整数)
└ new_rate	number(float)	分摊比例
└ rehire	enum	是否离职重聘，枚举如下： - no：否 - yes：是 - to_be_confirmed：待确定
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ rehire_employment_id	string	历史雇佣信息 ID，，可通过【批量查询员工信息】 或 【搜索员工信息】获取详细信息；类型不跟随 user_id_type
└ person_info	person_info	基本个人信息
└ person_id	string	个人信息 ID - 可用于 【更新个人信息】
└ phone_number	string	个人电话 - 该值取自 person_info.phone_list 中满足以下条件的个人电话 - is_primary=true - device_type=mobile_phone - phone_usage=home 字段权限要求（满足任一）： corehr:person.phone:read 获取个人手机号信息 corehr:person.phone:write 读写个人手机号信息
└ legal_name	string	法定姓名 字段权限要求（满足任一）： corehr:person.legal_name:read 获取法定姓名信息 corehr:person.legal_name:write 读写法定姓名信息
└ preferred_name	string	常用名 - 基于 local_primary、local_first_name、name_primary、first_name 等字段计算
└ preferred_local_full_name	string	常用本地全名
└ preferred_english_full_name	string	常用英文全名
└ name_list	person_name\[\]	姓名列表 字段权限要求（满足任一）： corehr:person.legal_name:read 获取法定姓名信息 corehr:person.legal_name:write 读写法定姓名信息
└ local_primary	string	姓 - 本地文字
└ local_first_name	string	名 - 本地文字
└ country_region_id	string	国家/地区 - 可通过【查询国家/地区信息】获取
└ name_type	enum	姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：name_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ local_first_name_2	string	名 - 第二本地文字
└ local_primary_2	string	姓 - 第二本地文字
└ additional_name	string	别名
└ additional_name_type	enum	补充姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：additional_name_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ first_name	string	名
└ full_name	string	全名
└ hereditary	string	姓氏称谓
└ custom_name	string	自定义姓名（未传入时，姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）
└ custom_local_name	string	本地文字的自定义姓名（未传入时，本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）
└ middle_name	string	中间名
└ name_primary	string	姓
└ secondary	string	第二姓氏
└ tertiary	string	婚后姓氏
└ social	enum	尊称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：social
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ title	enum	头衔 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：title
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ local_middle_name	string	本地中间名
└ local_secondary	string	第二姓氏 - 本地文字
└ display_name_local_and_western_script	string	展示姓名（本地和西方文字）
└ display_name_local_script	string	展示姓名（本地文字）
└ display_name_western_script	string	展示姓名（西方文字）
└ gender	enum	性别，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - custom_api_name：gender - object_api_name：person 字段权限要求（满足任一）： corehr:person.gender:read 获取性别信息 corehr:person.gender:write 读写性别信息
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ date_of_birth	string	出生日期 字段权限要求（满足任一）： corehr:person.date_of_birth:read 获取生日信息 corehr:person.date_of_birth:write 读写生日信息
└ nationality_id_v2	string	国籍 ID，可通过【查询国籍信息】查询 字段权限要求（满足任一）： corehr:person.nationality:read 获取国籍信息 corehr:person.nationality:write 读写国籍信息
└ race	enum	民族 / 种族，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - custom_api_name：ethnicity_race - object_api_name：person 字段权限要求： corehr:person.race:read 获取民族/种族信息
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ marital_status	enum	婚姻状况，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - custom_api_name：marital_status - object_api_name：person 字段权限要求（满足任一）： corehr:person.marital_status:read 获取婚姻状况信息 corehr:person.marital_status:write 读写婚姻状况信息
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_list	phone\[\]	电话列表 字段权限要求（满足任一）： corehr:person.phone:read 获取个人手机号信息 corehr:person.phone:write 读写个人手机号信息
└ international_area_code	enum	国家区号 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：international_area_code
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_number	string	电话号码
└ formatted_phone_number	string	完整电话号码
└ device_type	enum	设备类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：device_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_usage	enum	电话用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：phone_usage
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ is_primary	boolean	主要电话
└ is_public	boolean	公开电话
└ address_list	address\[\]	地址列表 字段权限要求（满足任一）： corehr:person.address:read 读取个人地址信息 corehr:person.address:write 读写个人地址信息
└ full_address_local_script	string	完整地址（本地文字）
└ full_address_western_script	string	完整地址（西方文字）
└ address_id	string	地址 ID，用于【更新个人信息】联系地址
└ country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ region_id	string	主要行政区 - 可通过【查询省份/主要行政区信息】获取
└ city_id	string	城市（该字段待作废，请勿使用）
└ distinct_id	string	区/县（该字段待作废，请勿使用）
└ city_id_v2	string	城市
└ district_id_v2	string	区/县
└ address_line1	string	地址行 1
└ address_line2	string	地址行 2
└ address_line3	string	地址行 3
└ address_line4	string	地址行 4
└ address_line5	string	地址行 5
└ address_line6	string	地址行 6
└ address_line7	string	地址行 7
└ address_line8	string	地址行 8
└ address_line9	string	地址行 9
└ local_address_line1	string	地址行 1（非拉丁语系的本地文字）
└ local_address_line2	string	地址行 2（非拉丁语系的本地文字）
└ local_address_line3	string	地址行 3（非拉丁语系的本地文字）
└ local_address_line4	string	地址行 4（非拉丁语系的本地文字）
└ local_address_line5	string	地址行 5（非拉丁语系的本地文字）
└ local_address_line6	string	地址行 6（非拉丁语系的本地文字）
└ local_address_line7	string	地址行 7（非拉丁语系的本地文字）
└ local_address_line8	string	地址行 8（非拉丁语系的本地文字）
└ local_address_line9	string	地址行 9（非拉丁语系的本地文字）
└ postal_code	string	邮政编码
└ address_type_list	enum\[\]	地址类型
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ is_primary	boolean	主要地址
└ is_public	boolean	公开地址
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ city_subdivision_1	string	城市往下细分 1 层的行政区
└ city_subdivision_2	string	城市往下细分 2 层的行政区
└ region_subdivision_1	string	主要行政区往下细分 1 层的行政区
└ region_subdivision_2	string	主要行政区往下细分 2 层的行政区
└ email_list	email\[\]	邮箱列表 - 请使用 work_email_list 获取工作邮箱 字段权限要求（满足任一）： corehr:person.email:read 获取个人邮箱信息 corehr:person.email:write 读写个人邮箱信息
└ email	string	邮箱地址
└ is_primary	boolean	是否为主要邮箱
└ is_public	boolean	是否为公开邮箱
└ email_usage	enum	邮箱用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: email - custom_api_name: email_usage
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ work_experience_list	work_experience_info\[\]	工作经历列表 字段权限要求（满足任一）： corehr:person.work_experience:read 获取工作履历信息 corehr:person.work_experience:write 读写工作履历信息
└ company_organization	i18n\[\]	公司 / 组织
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ department	i18n\[\]	部门
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ job	i18n\[\]	岗位
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ description	i18n\[\]	工作描述
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ start_date	string	开始日期
└ end_date	string	结束日期
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ education_list	education\[\]	教育经历列表 字段权限要求（满足任一）： corehr:person.education:read 获取教育经历信息 corehr:person.education:write 读写教育经历信息
└ school	i18n\[\]	学校 - 自定义名称时返回该字段 - 下拉框选择的返回 school_name 字段
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ level_of_education	enum	学历 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：level_of_education
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ start_date	string	开始日期
└ end_date	string	结束日期
└ field_of_study	i18n\[\]	专业 - 自定义名称时返回该字段 - 下拉框选择的返回 field_of_study_name 字段
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ degree	enum	学位 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：degree
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ school_name	enum	学校名称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：school_name - 自定义名称时返回 school 字段 - 下拉框选择的返回该字段
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ field_of_study_name	enum	专业名称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：field_of_study_name - 自定义名称时返回 field_of_study 字段 - 下拉框选择的返回该字段
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ expected_end_date	string	预期结束日期
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ bank_account_list	bank_account\[\]	银行账户 字段权限要求（满足任一）： corehr:person.bank_account:read 获取银行账号列表信息 corehr:person.bank_account:write 读写银行账号信息
└ bank_name	string	银行名称。当在飞书人事找不到银行下拉选项，手动填写文本时，请通过此字段获取结果
└ bank_account_number	string	银行账号
└ account_holder	string	开户人姓名
└ branch_name	string	支行名称。当在飞书人事找不到支行下拉选项，手动填写文本时，请通过此字段获取结果
└ bank_id_v2	string	银行 ID，详细信息可通过【查询银行信息】查询。当在飞书人事选择具体银行下拉选项时，请通过此字段获取结果
└ branch_id_v2	string	支行 ID，要求必须为填入银行的支行，详细信息可通过【查询支行信息】查询。当在飞书人事选择具体支行下拉选项时，请通过此字段获取结果
└ country_region_id	string	国家/地区 ID，详细信息可通过【查询国家/地区信息v2】查询
└ bank_account_usage	enum\[\]	银行卡用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: bank_account - custom_api_name: bank_account_usage
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ bank_account_type	enum	银行卡类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: bank_account - custom_api_name: bank_account_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ payment_type	enum	分配方式 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: bank_account - custom_api_name: payment_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ payment_rate	string	分配比例 - 数字类型，最多精确两位小数
└ payment_amount	string	分配金额 - 数字类型，最多精确两位小数
└ priority	int	分配优先级 - 升序，即值越小，优先级越高
└ currency_id	string	货币id，可通过【查询货币信息v2】查询
└ IBAN	string	国际银行账号
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ national_id_list	national_id\[\]	证件 字段权限要求（满足任一）： corehr:person.national_id:read 获取证件信息 corehr:person.national_id:write 读写证件信息
└ national_id_type_id	string	国家证件类型，可通过【查询单个国家证件类型】获取详细信息
└ national_id_number	string	证件号码
└ issue_date	string	证件签发日期
└ expiration_date	string	证件到期日期
└ country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ issued_by	string	证件签发机构
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ dependent_list	dependent\[\]	家庭成员列表 字段权限要求（满足任一）： corehr:person.dependent:read 获取家庭成员信息 corehr:person.dependent:write 读写家庭成员信息
└ id	string	ID
└ name	person_name	姓名
└ local_primary	string	姓 - 本地文字
└ local_first_name	string	名 - 本地文字
└ country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ name_type	enum	姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：name_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ local_first_name_2	string	名 - 第二本地文字
└ local_primary_2	string	姓 - 第二本地文字
└ additional_name	string	别名
└ additional_name_type	enum	补充姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：additional_name_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ first_name	string	名
└ full_name	string	全名
└ hereditary	string	姓氏称谓
└ custom_name	string	自定义姓名（未传入时，姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）
└ custom_local_name	string	本地文字的自定义姓名（未传入时，本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）
└ middle_name	string	中间名
└ name_primary	string	姓
└ secondary	string	第二姓氏
└ tertiary	string	婚后姓氏
└ social	enum	尊称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：social
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ title	enum	头衔 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：social
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ local_middle_name	string	本地中间名
└ local_secondary	string	第二姓氏 - 本地文字
└ display_name_local_and_western_script	string	展示姓名（本地和西方文字）
└ display_name_local_script	string	展示姓名（本地文字）
└ display_name_western_script	string	展示姓名（西方文字）
└ relationship	enum	关系 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：emergency_contact - custom_api_name：relationship
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ gender	enum	性别 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person - custom_api_name：gender
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ date_of_birth	string	生日
└ nationality_id_v2	string	国籍 ID，可通过【查询国籍信息】查询
└ national_id_list	national_id\[\]	证件号码
└ national_id_type_id	string	国家证件类型，可通过【查询单个国家证件类型】获取详细信息
└ national_id_number	string	证件号码
└ issue_date	string	证件签发日期
└ expiration_date	string	证件到期日期
└ country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ issued_by	string	证件签发机构
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ spouses_working_status	enum	配偶工作状态 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：dependent - custom_api_name：spouses_working_status
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ is_this_person_covered_by_health_insurance	boolean	包含家属医疗保险
└ is_this_person_allowed_for_tax_deduction	boolean	允许家属抵扣税款
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ dependent_name	string	家庭成员姓名
└ employer	string	工作单位
└ job	string	岗位
└ phone	phone	电话
└ international_area_code	enum	国家区号， - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：international_area_code
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_number	string	电话号码
└ formatted_phone_number	string	完整电话号码
└ device_type	enum	设备类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：device_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_usage	enum	电话用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：phone_usage
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ is_primary	boolean	主要电话
└ is_public	boolean	公开电话
└ address	address	联系地址
└ full_address_local_script	string	完整地址（本地文字）
└ full_address_western_script	string	完整地址（西方文字）
└ address_id	string	地址 ID
└ country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ region_id	string	主要行政区 - 可通过【查询省份/主要行政区信息】获取
└ city_id	string	城市（该字段待作废，请勿使用）
└ distinct_id	string	区/县（该字段待作废，请勿使用）
└ city_id_v2	string	城市
└ district_id_v2	string	区/县
└ address_line1	string	地址行 1
└ address_line2	string	地址行 2
└ address_line3	string	地址行 3
└ address_line4	string	地址行 4
└ address_line5	string	地址行 5
└ address_line6	string	地址行 6
└ address_line7	string	地址行 7
└ address_line8	string	地址行 8
└ address_line9	string	地址行 9
└ local_address_line1	string	地址行 1（非拉丁语系的本地文字）
└ local_address_line2	string	地址行 2（非拉丁语系的本地文字）
└ local_address_line3	string	地址行 3（非拉丁语系的本地文字）
└ local_address_line4	string	地址行 4（非拉丁语系的本地文字）
└ local_address_line5	string	地址行 5（非拉丁语系的本地文字）
└ local_address_line6	string	地址行 6（非拉丁语系的本地文字）
└ local_address_line7	string	地址行 7（非拉丁语系的本地文字）
└ local_address_line8	string	地址行 8（非拉丁语系的本地文字）
└ local_address_line9	string	地址行 9（非拉丁语系的本地文字）
└ postal_code	string	邮政编码
└ address_type_list	enum\[\]	地址类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：address - custom_api_name：address_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ is_primary	boolean	主要地址
└ is_public	boolean	公开地址
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ birth_certificate_of_child	file\[\]	出生证明
└ id	string	上传文件ID
└ name	string	文件名
└ emergency_contact_list	emergency_contact\[\]	紧急联系人列表 字段权限要求（满足任一）： corehr:person.emergency_contact:read 获取紧急联系人信息 corehr:person.emergency_contact:write 读写紧急联系人信息
└ id	string	ID
└ name	person_name	姓名
└ local_primary	string	姓 - 本地文字
└ local_first_name	string	名 - 本地文字
└ country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ name_type	enum	姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：name_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ local_first_name_2	string	名 - 第二本地文字
└ local_primary_2	string	姓 - 第二本地文字
└ additional_name	string	别名
└ additional_name_type	enum	补充姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：additional_name_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ first_name	string	名
└ full_name	string	全名
└ hereditary	string	姓氏称谓
└ custom_name	string	自定义姓名（未传入时，姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）
└ custom_local_name	string	本地文字的自定义姓名（未传入时，本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）
└ middle_name	string	中间名
└ name_primary	string	姓
└ secondary	string	第二姓氏
└ tertiary	string	婚后姓氏
└ social	enum	尊称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：social
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ title	enum	头衔 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：social
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ local_middle_name	string	本地中间名
└ local_secondary	string	第二姓氏 - 本地文字
└ display_name_local_and_western_script	string	展示姓名（本地和西方文字）
└ display_name_local_script	string	展示姓名（本地文字）
└ display_name_western_script	string	展示姓名（西方文字）
└ relationship	enum	关系 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：dependent - custom_api_name：relationship_with_dependent
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_ist	phone\[\]	电话
└ international_area_code	enum	国家区号 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：international_area_code
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_number	string	电话号码
└ formatted_phone_number	string	完整电话号码
└ device_type	enum	设备类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：device_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_usage	enum	电话用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：phone_usage
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ is_primary	boolean	主要电话
└ is_public	boolean	公开电话
└ phone_list	phone\[\]	电话
└ international_area_code	enum	国家区号 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：international_area_code
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_number	string	电话号码
└ formatted_phone_number	string	完整电话号码
└ device_type	enum	设备类型
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ phone_usage	enum	电话用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：phone_usage
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ is_primary	boolean	主要电话
└ is_public	boolean	公开电话
└ legal_name	string	法定姓名
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ address	address	联系地址
└ full_address_local_script	string	完整地址（本地文字）
└ full_address_western_script	string	完整地址（西方文字）
└ address_id	string	地址 ID
└ country_region_id	string	国家 / 地区
└ region_id	string	主要行政区 - 可通过【查询省份/主要行政区信息】获取
└ city_id	string	城市（该字段待作废，请勿使用）
└ distinct_id	string	区/县（该字段待作废，请勿使用）
└ city_id_v2	string	城市
└ district_id_v2	string	区/县
└ address_line1	string	地址行 1
└ address_line2	string	地址行 2
└ address_line3	string	地址行 3
└ address_line4	string	地址行 4
└ address_line5	string	地址行 5
└ address_line6	string	地址行 6
└ address_line7	string	地址行 7
└ address_line8	string	地址行 8
└ address_line9	string	地址行 9
└ local_address_line1	string	地址行 1（非拉丁语系的本地文字）
└ local_address_line2	string	地址行 2（非拉丁语系的本地文字）
└ local_address_line3	string	地址行 3（非拉丁语系的本地文字）
└ local_address_line4	string	地址行 4（非拉丁语系的本地文字）
└ local_address_line5	string	地址行 5（非拉丁语系的本地文字）
└ local_address_line6	string	地址行 6（非拉丁语系的本地文字）
└ local_address_line7	string	地址行 7（非拉丁语系的本地文字）
└ local_address_line8	string	地址行 8（非拉丁语系的本地文字）
└ local_address_line9	string	地址行 9（非拉丁语系的本地文字）
└ postal_code	string	邮政编码
└ address_type_list	enum\[\]	地址类型
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ is_primary	boolean	主要地址
└ is_public	boolean	公开地址
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ date_entered_workforce	string	参加工作日期 字段权限要求（满足任一）： corehr:person.date_entered_workforce:read 获取参加工作日期 corehr:person.date_entered_workforce:write 读写参加工作日期
└ working_years	int	工龄
└ profile_image_id	string	头像资源的 ID
└ email_address	string	个人邮箱地址 - 计算字段，取自 person_info.email_list 中 - email_usage: home - is_primary: true 字段权限要求（满足任一）： corehr:person.email:read 获取个人邮箱信息 corehr:person.email:write 读写个人邮箱信息
└ age	int	年龄 字段权限要求（满足任一）： corehr:person.date_of_birth:read 获取生日信息 corehr:person.date_of_birth:write 读写生日信息
└ highest_level_of_education	education	最高学历教育经历 字段权限要求（满足任一）： corehr:person.education:read 获取教育经历信息 corehr:person.education:write 读写教育经历信息
└ school	i18n\[\]	学校 - 自定义名称时返回该字段 - 下拉框选择的返回 school_name 字段
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ level_of_education	enum	学历 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：level_of_education
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ start_date	string	开始日期
└ end_date	string	结束日期
└ field_of_study	i18n\[\]	专业 - 自定义名称时返回该字段 - 下拉框选择的返回 field_of_study_name 字段
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ degree	enum	学位 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：degree
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ school_name	enum	学校名称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：school_name - 自定义名称时返回 school 字段 - 下拉框选择的返回该字段
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ field_of_study_name	enum	专业名称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：field_of_study_name - 自定义名称时返回 field_of_study 字段 - 下拉框选择的返回该字段
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ expected_end_date	string	预期结束日期
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ highest_degree_of_education	education	最高学位教育经历 字段权限要求（满足任一）： corehr:person.education:read 获取教育经历信息 corehr:person.education:write 读写教育经历信息
└ school	i18n\[\]	学校 - 自定义名称时返回该字段 - 下拉框选择的返回 school_name 字段
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ level_of_education	enum	学历 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：level_of_education
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ start_date	string	开始日期
└ end_date	string	结束日期
└ field_of_study	i18n\[\]	专业 - 自定义名称时返回该字段 - 下拉框选择的返回 field_of_study_name 字段
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ degree	enum	学位 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：degree
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ school_name	enum	学校名称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：school_name - 自定义名称时返回 school 字段 - 下拉框选择的返回该字段
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ field_of_study_name	enum	专业名称 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：field_of_study_name - 自定义名称时返回 field_of_study 字段 - 下拉框选择的返回该字段
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ country_region_id	string	国家地区ID，可通过 【查询国家/地区信息】 获取详细信息
└ expected_end_date	string	预期结束日期
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ personal_profile	personal_profile\[\]	个人资料附件 字段权限要求（满足任一）： corehr:person.personal_profile:read 获取个人资料信息 corehr:person.personal_profile:write 读写个人资料信息
└ personal_profile_type	enum	资料类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：personal_profile - custom_api_name：profile_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ files	file\[\]	上传文件列表
└ id	string	上传文件ID，可用于【下载文件】
└ name	string	文件名
└ native_region	string	籍贯 ID，可通过【查询省份/主要行政区信息】获取 字段权限要求（满足任一）： corehr:person.native_region:read 获取籍贯信息 corehr:person.native_region:write 读写籍贯信息
└ hukou_type	enum	户口类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: person_info_chn - custom_api_name: hukou_type 字段权限要求（满足任一）： corehr:person.hukou:read 获取户口信息 corehr:person.hukou:write 读写户口信息
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ hukou_location	string	户口所在地 字段权限要求（满足任一）： corehr:person.hukou:read 获取户口信息 corehr:person.hukou:write 读写户口信息
└ political_affiliations	enum\[\]	政治面貌，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - custom_api_name：political_affiliation - object_api_name：person_info_chn 字段权限要求（满足任一）： corehr:person.political_affiliation:read 获取政治面貌信息 corehr:person.political_affiliation:write 读写个人政治面貌信息
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ talent_id	string	人才 ID，用于【获取人才信息】
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】 字段权限要求（满足任一）： corehr:person.custom_field:read 获取个人信息自定义字段信息 corehr:person.custom_field:write 读写个人信息中的自定义字段信息
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ national_id_number	string	居民身份证件号码 字段权限要求（满足任一）： corehr:person.national_id:read 获取证件信息 corehr:person.national_id:write 读写证件信息
└ family_address	string	家庭地址 字段权限要求（满足任一）： corehr:person.address:read 读取个人地址信息 corehr:person.address:write 读写个人地址信息
└ born_country_region	string	出生国家/地区 字段权限要求（满足任一）： corehr:person.born_country_region:read 获取出生国家/地区信息 corehr:person.born_country_region:write 读写出生国家/地区信息
└ is_disabled	boolean	是否残疾 字段权限要求（满足任一）： corehr:person.is_disabled:read 获取残疾信息 corehr:person.is_disabled:write 读写残疾信息
└ disable_card_number	string	残疾证号 字段权限要求（满足任一）： corehr:person.is_disabled:read 获取残疾信息 corehr:person.is_disabled:write 读写残疾信息
└ is_martyr_family	boolean	是否烈属 字段权限要求（满足任一）： corehr:person.martyr_family:read 获取烈属信息 corehr:person.martyr_family:write 读写烈属信息
└ martyr_card_number	string	烈属证号 字段权限要求（满足任一）： corehr:person.martyr_family:read 获取烈属信息 corehr:person.martyr_family:write 读写烈属信息
└ is_old_alone	boolean	是否孤老 字段权限要求（满足任一）： corehr:person.is_old_alone:read 获取孤老信息 corehr:person.is_old_alone:write 读写孤老信息
└ resident_taxes	resident_tax\[\]	居民身份信息 字段权限要求（满足任一）： corehr:person.resident_tax:read 获取居民身份信息 corehr:person.resident_tax:write 读写居民身份信息
└ year_resident_tax	string	年度
└ resident_status	enum	居民身份，枚举值 api_name 可通过获取字段详情接口查询，查询参数如下： - object_api_name：resident_tax - custom_api_name：resident_status
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ tax_country_region_id	string	国家/地区，可通过【查询国家/地区信息】获取
└ custom_fields	object_field_data\[\]	自定义字段 - 请参考【自定义字段说明】 字段权限要求（满足任一）： corehr:person.resident_tax_custom_field:read 获取居民身份自定义字段信息 corehr:person.resident_tax_custom_field:write 读写居民身份自定义字段信息
└ field_name	string	字段名
└ value	string	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
└ first_entry_time	string	首次入境日期 字段权限要求（满足任一）： corehr:person.entry_leave_time:read 获取出入境日期信息 corehr:person.entry_leave_time:write 读写出入境日期信息
└ leave_time	string	预计离境日期 字段权限要求（满足任一）： corehr:person.entry_leave_time:read 获取出入境日期信息 corehr:person.entry_leave_time:write 读写出入境日期信息
└ religion	enum	宗教信仰 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person - custom_api_name：religion 字段权限要求（满足任一）： corehr:person.religion:read 查看宗教信仰信息 corehr:person.religion:write 读写宗教信仰信息
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ working_years_v2	number(float)	工龄 浮点类型
└ custom_fields	custom_field_data\[\]	自定义字段 - 请参考【自定义字段说明】 字段权限要求： corehr:employment.custom_field:read 获取雇佣信息自定义字段信息
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ noncompete_status	enum	竞业状态 - 可通过获取字段详情接口查询，查询参数如下： - object_api_name：employment - custom_api_name：noncompete_status
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ past_offboarding	boolean	是否历史离职人员
└ regular_employee_start_date	string	转正式日期
└ external_id	string	外部系统 ID , 可存储租户系统中的员工 ID
└ times_employed	int	入职次数
└ recruitment_type	enum	招聘来源 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：employment - custom_api_name：recruitment_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ avatar_url	string	员工头像（即飞书头像）
└ primary_contract_id	string	主合同 ID，可通过【查询单个合同】获取详细信息
└ contract_start_date	string	主合同开始日期 字段权限要求（满足任一）： corehr:contract.period:read 获取合同期限信息 corehr:contract.period:write 读写合同期限信息
└ contract_end_date	string	主合同到期日期 字段权限要求（满足任一）： corehr:contract.period:read 获取合同期限信息 corehr:contract.period:write 读写合同期限信息
└ contract_expected_end_date	string	主合同预计到期日期 字段权限要求（满足任一）： corehr:contract.period:read 获取合同期限信息 corehr:contract.period:write 读写合同期限信息
└ pay_group_id	string	所属薪资组 ID 字段权限要求： corehr:employment.pay_group:read 获取薪资组信息
└ assignment_pay_group_id	string	所属外派薪资组 ID 字段权限要求： corehr:employment.assignment_pay_group:read 获取员工所属外派薪资组
└ international_assignment	boolean	是否外派 字段权限要求： corehr:employment.assignment:read 获取员工外派信息
└ work_calendar_id	string	工作日历 ID - 可通过【查询工作日历】查询
└ department	basic_department	部门基本信息
└ id	string	部门 ID - 可通过批量查询部门V2 或者搜索部门信息 获取详情 - 类型与 department_id_type 一致
└ id_v2	string	部门 ID，当按照department_id_type转换失败时返回为空值 - 可通过批量查询部门V2 或者搜索部门信息 获取详情 - 类型与 department_id_type 一致
└ department_name	i18n\[\]	部门名称
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ direct_manager	basic_employee	直接上级基本信息
└ employment_id	string	雇佣 ID，类型与 user_id_type 一致
└ employment_id_v2	string	雇佣 ID - 类型与 user_id_type 一致，转换失败时返回空值
└ employee_number	string	工号
└ email_address	string	邮箱地址
└ person_info	basic_person_info	基本个人信息
└ person_id	string	个人信息 ID，在创建个人信息时生成的 ID 值
└ preferred_name	string	常用名 - 基于 local_primary、local_first_name、name_primary、first_name 等字段计算
└ preferred_local_full_name	string	常用本地全名
└ preferred_english_full_name	string	常用英文全名
└ dotted_line_manager	basic_employee	虚线上级基本信息
└ employment_id	string	雇佣 ID，类型与 user_id_type 一致
└ employment_id_v2	string	雇佣 ID - 类型与 user_id_type 一致，转换失败时返回空值
└ employee_number	string	工号
└ email_address	string	邮箱地址
└ person_info	basic_person_info	基本个人信息
└ person_id	string	个人信息 ID
└ preferred_name	string	常用名 - 基于 local_primary、local_first_name、name_primary、first_name 等字段计算
└ preferred_local_full_name	string	常用本地全名
└ preferred_english_full_name	string	常用英文全名
└ time_zone	string	时区
└ service_company	string	任职公司，可通过【查询单个公司】查询详细信息 字段权限要求： corehr:job_data.service_company:read 获取任职公司
└ compensation_type	enum	薪资类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：compensation_type 字段权限要求： corehr:job_data.compensation_type:read 获取薪资类型
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ work_shift	enum	排班类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：work_shift 字段权限要求： corehr:job_data.work_shift:read 获取排班信息
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ custom_org	string	自定义组织 - 功能灰度中，如有需求请联系技术支持 字段权限要求（满足任一）： corehr:employment.custom_org_field:read 获取员工的自定义组织信息 corehr:employment.custom_org_field:write 读写员工的自定义组织信息
└ seniority_adjust_information_list	seniority_adjust_information\[\]	司龄调整信息 字段权限要求（满足任一）： corehr:employment.seniority_adjust_information:read 获取员工司龄调整信息 corehr:employment.seniority_adjust_information:write 读写员工司龄调整信息
└ seniority_adjustment_type	enum	调整类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：seniority_adjust_information - custom_api_name：seniority_adjustment_type
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ start_date	string	开始日期 - 格式： yyyy-mm-dd
└ end_date	string	结束日期 - 格式： yyyy-mm-dd
└ seniority_adjustment	number(float)	调整值 - 精确度：两位小数 - 单位：年
└ reasons_for_seniority_adjustment	string	调整原因
└ custom_fields	custom_field_data\[\]	自定义字段 - 具体支持的对象请参考【自定义字段说明】
└ custom_api_name	string	自定义字段 apiname，即自定义字段的唯一标识
└ name	custom_name	自定义字段名称
└ zh_cn	string	中文
└ en_us	string	英文
└ type	int	自定义字段类型
└ value	string	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"）
└ employment_direct_bps	employment_bp	员工直属 BP 信息，当员工所在部门、属地无 BP 时，会上钻找到最近的 BP 字段权限要求： corehr:employee.bp:read 查看员工的部分 BP 信息
└ hrbp_ids	string\[\]	员工直属 HRBP 雇佣 ID，若员工是部门负责人，且同部门 HRBP 在权限中配置了 HRBP 不可见部门负责人，则在结果中不会出现该 HRBP - 类型与 user_id_type 一致
└ location_bp_ids	string\[\]	员工直属属地 BP 雇佣 ID - 类型与 user_id_type 一致
└ employment_all_bps	employment_bp	员工全部 BP 信息 字段权限要求： corehr:employee.all_bp:read 查看员工的全部 BP 信息
└ hrbp_ids	string\[\]	员工所在部门及上级部门全部 HRBP 雇佣 ID - 类型与 user_id_type 一致
└ location_bp_ids	string\[\]	员工所在部门及上级部门全部属地 BP 雇佣 ID - 类型与 user_id_type 一致
└ contract_type	enum	当前所属合同类型 - 可通过获取字段详情查询 - object_api_name：contract - custom_api_name：contract_type 字段权限要求： corehr:employment.contract_type:read 获取员工合同类型
└ enum_name	string	枚举值
└ display	i18n\[\]	枚举多语展示
└ lang	string	语言编码（IETF BCP 47）
└ value	string	文本内容
└ archive_cpst_plan_id	string	当前所属薪资方案 ID - 可结合批量查询薪资方案接口使用 字段权限要求： corehr:employment.archive_cpst_plan:read 获取员工薪资方案

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "employment_id": "6893014062142064135",
                "employment_id_v2": "6893014062142064135",
                "ats_application_id": "6838119494196871234",
                "prehire_id": "7023239238976141133",
                "employee_number": "1000000",
                "employee_type_id": "6971090097697521314",
                "employee_subtype_id": "6971090097697521317",
                "department_id": "6893014062142064135",
                "department_id_v2": "6893014062142064135",
                "job_level_id": "6893014062142064135",
                "job_level": {
                    "id": "4692446793125560154",
                    "level_order": 9999,
                    "code": "VQzo/BSonp8l6PmcZ+VlDhkd2595LMkhyBAGX6HAlCY=",
                    "name": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "description": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "active": true,
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                },
                "pathway_id": "6893014062142064135",
                "pathway": {
                    "id": "4692446793125560154",
                    "code": "VQzo/BSonp8l6PmcZ+VlDhkd2595LMkhyBAGX6HAlCY=",
                    "name": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "description": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "active": true,
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                },
                "job_grade_id": "6893014062142064135",
                "work_location_id": "6893014062142064135",
                "job_family_id": "6893014062142064135",
                "job_family": {
                    "id": "4698019107896524633",
                    "name": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "active": true,
                    "parent_id": "4698020757495316313",
                    "effective_time": "2020-05-01 00:00:00",
                    "expiration_time": "2020-05-02 00:00:00",
                    "code": "123456",
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                },
                "position_id": "6893014062142064135",
                "position": {
                    "position_id": "4692446793125560154",
                    "code": "A01234",
                    "names": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "descriptions": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "active": true
                },
                "job_id": "6893014062142064135",
                "job": {
                    "id": "4698040628992333549",
                    "code": "JP422119",
                    "name": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "description": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "active": true,
                    "job_title": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "pathway_id": "4719519211875096301",
                    "job_family_id_list": [
                        "4719519211875096301"
                    ],
                    "job_level_id_list": [
                        "4719519212005299950"
                    ],
                    "working_hours_type_id": "6890452208593372679",
                    "effective_time": "2020-01-01 00:00:00",
                    "expiration_time": "2021-01-01 00:00:00",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "Sandy"
                        }
                    ]
                },
                "company_id": "6893014062142064135",
                "working_hours_type_id": "6893014062142064135",
                "tenure": "0.01",
                "seniority_date": "2021-03-16",
                "effective_date": "2021-03-16",
                "primary_employment": true,
                "probation_period": 16,
                "on_probation": true,
                "probation_end_date": "2022-08-01",
                "direct_manager_id": "7027024823985411287",
                "dotted_line_manager_id": "7027024823985411782",
                "direct_manager_id_v2": "7027024823985411287",
                "dotted_line_manager_id_v2": "7027024823985411782",
                "employment_type": {
                    "enum_name": "employee",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "employment_status": {
                    "enum_name": "hired",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "expiration_date": "2022-08-16",
                "reason_for_offboarding": {
                    "enum_name": "voluntary",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "email_address": "test@163.com",
                "work_email_list": [
                    {
                        "email": "1234567@example.feishu.cn",
                        "email_usage": {
                            "enum_name": "home",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        }
                    }
                ],
                "cost_center_list": [
                    {
                        "cost_center_id": "6950635856373745165",
                        "rate": 100,
                        "new_rate": 50.2
                    }
                ],
                "rehire": {
                    "enum_name": "yes",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "rehire_employment_id": "7164286667866966659",
                "person_info": {
                    "person_id": "6919733936050406926",
                    "phone_number": "13649211111",
                    "legal_name": "张三",
                    "preferred_name": "刘梓新(Henry)",
                    "preferred_local_full_name": "刘梓新",
                    "preferred_english_full_name": "Henry",
                    "name_list": [
                        {
                            "local_primary": "黄",
                            "local_first_name": "四",
                            "country_region_id": "6862995757234914824",
                            "name_type": {
                                "enum_name": "legal_name",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "local_first_name_2": "五",
                            "local_primary_2": "王",
                            "additional_name": "别名",
                            "additional_name_type": {
                                "enum_name": "legal_name",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "first_name": "帅",
                            "full_name": "王大帅",
                            "hereditary": "王",
                            "custom_name": "王大帅",
                            "custom_local_name": "王大帅",
                            "middle_name": "大",
                            "name_primary": "王",
                            "secondary": "王",
                            "tertiary": "王",
                            "social": {
                                "enum_name": "example",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "title": {
                                "enum_name": "example",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "local_middle_name": "大",
                            "local_secondary": "王",
                            "display_name_local_and_western_script": "王大帅",
                            "display_name_local_script": "王大帅",
                            "display_name_western_script": "王大帅"
                        }
                    ],
                    "gender": {
                        "enum_name": "male",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "date_of_birth": "2020-01-01",
                    "nationality_id_v2": "6862995757234914821",
                    "race": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "marital_status": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "phone_list": [
                        {
                            "international_area_code": {
                                "enum_name": "86_china",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "phone_number": "010-12345678",
                            "formatted_phone_number": "+86 010-12345678",
                            "device_type": {
                                "enum_name": "mobile_phone",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "phone_usage": {
                                "enum_name": "home",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "is_primary": true,
                            "is_public": true
                        }
                    ],
                    "address_list": [
                        {
                            "full_address_local_script": "中国北京北京",
                            "full_address_western_script": "Beijing, Beijing, China,",
                            "address_id": "6989822217869624863",
                            "country_region_id": "6862995757234914824",
                            "region_id": "6863326815667095047",
                            "city_id": "6863333254578046471",
                            "distinct_id": "6863333516579440141",
                            "city_id_v2": "6863333254578046471",
                            "district_id_v2": "6863333516579440141",
                            "address_line1": "丹佛测试地址-纽埃时区",
                            "address_line2": "PoewH",
                            "address_line3": "PoewH",
                            "address_line4": "jmwJc",
                            "address_line5": "jmwJc",
                            "address_line6": "jmwJc",
                            "address_line7": "jmwJc",
                            "address_line8": "rafSu",
                            "address_line9": "McPRG",
                            "local_address_line1": "丹佛测试地址-纽埃时区",
                            "local_address_line2": "PoewH",
                            "local_address_line3": "PoewH",
                            "local_address_line4": "jmwJc",
                            "local_address_line5": "jmwJc",
                            "local_address_line6": "jmwJc",
                            "local_address_line7": "jmwJc",
                            "local_address_line8": "rafSu",
                            "local_address_line9": "McPRG",
                            "postal_code": "611530",
                            "address_type_list": [
                                {
                                    "enum_name": "home_address",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                }
                            ],
                            "is_primary": true,
                            "is_public": true,
                            "custom_fields": [
                                {
                                    "custom_api_name": "name",
                                    "name": {
                                        "zh_cn": "自定义姓名",
                                        "en_us": "Custom Name"
                                    },
                                    "type": 1,
                                    "value": "\"231\""
                                }
                            ],
                            "city_subdivision_1": "123",
                            "city_subdivision_2": "123",
                            "region_subdivision_1": "123",
                            "region_subdivision_2": "123"
                        }
                    ],
                    "email_list": [
                        {
                            "email": "1234567@example.feishu.cn",
                            "is_primary": true,
                            "is_public": true,
                            "email_usage": {
                                "enum_name": "home",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            }
                        }
                    ],
                    "work_experience_list": [
                        {
                            "company_organization": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ],
                            "department": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ],
                            "job": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ],
                            "description": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ],
                            "start_date": "2020-01-01",
                            "end_date": "2020-01-01",
                            "custom_fields": [
                                {
                                    "custom_api_name": "name",
                                    "name": {
                                        "zh_cn": "自定义姓名",
                                        "en_us": "Custom Name"
                                    },
                                    "type": 1,
                                    "value": "\"231\""
                                }
                            ]
                        }
                    ],
                    "education_list": [
                        {
                            "school": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ],
                            "level_of_education": {
                                "enum_name": "phd",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "start_date": "2011-09-01",
                            "end_date": "2015-06-30",
                            "field_of_study": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ],
                            "degree": {
                                "enum_name": "phd",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "school_name": {
                                "enum_name": "example",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "field_of_study_name": {
                                "enum_name": "example",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "country_region_id": "1",
                            "expected_end_date": "2011-09-01",
                            "custom_fields": [
                                {
                                    "custom_api_name": "name",
                                    "name": {
                                        "zh_cn": "自定义姓名",
                                        "en_us": "Custom Name"
                                    },
                                    "type": 1,
                                    "value": "\"231\""
                                }
                            ]
                        }
                    ],
                    "bank_account_list": [
                        {
                            "bank_name": "中国农业银行",
                            "bank_account_number": "6231200000001223",
                            "account_holder": "孟十五",
                            "branch_name": "中国农业银行支行",
                            "bank_id_v2": "MDBH00000001",
                            "branch_id_v2": "MDBK00000017",
                            "country_region_id": "12",
                            "bank_account_usage": [
                                {
                                    "enum_name": "payment",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                }
                            ],
                            "bank_account_type": {
                                "enum_name": "checking",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "payment_type": {
                                "enum_name": "balance",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "payment_rate": "70.21",
                            "payment_amount": "5000",
                            "priority": 1,
                            "currency_id": "12",
                            "IBAN": "CH56 0483 5012 3456 7800 9",
                            "custom_fields": [
                                {
                                    "custom_api_name": "name",
                                    "name": {
                                        "zh_cn": "自定义姓名",
                                        "en_us": "Custom Name"
                                    },
                                    "type": 1,
                                    "value": "\"231\""
                                }
                            ]
                        }
                    ],
                    "national_id_list": [
                        {
                            "national_id_type_id": "6863330041896371725",
                            "national_id_number": "1231131333",
                            "issue_date": "2020-04-01",
                            "expiration_date": "2020-05-21",
                            "country_region_id": "6862995757234914824",
                            "issued_by": "北京市公安局",
                            "custom_fields": [
                                {
                                    "custom_api_name": "name",
                                    "name": {
                                        "zh_cn": "自定义姓名",
                                        "en_us": "Custom Name"
                                    },
                                    "type": 1,
                                    "value": "\"231\""
                                }
                            ]
                        }
                    ],
                    "dependent_list": [
                        {
                            "id": "123",
                            "name": {
                                "local_primary": "黄",
                                "local_first_name": "四",
                                "country_region_id": "6862995757234914824",
                                "name_type": {
                                    "enum_name": "legal_name",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "local_first_name_2": "五",
                                "local_primary_2": "王",
                                "additional_name": "别名",
                                "additional_name_type": {
                                    "enum_name": "legal_name",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "first_name": "帅",
                                "full_name": "王大帅",
                                "hereditary": "王",
                                "custom_name": "王大帅",
                                "custom_local_name": "王大帅",
                                "middle_name": "大",
                                "name_primary": "王",
                                "secondary": "王",
                                "tertiary": "王",
                                "social": {
                                    "enum_name": "example",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "title": {
                                    "enum_name": "exmaple",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "local_middle_name": "大",
                                "local_secondary": "王",
                                "display_name_local_and_western_script": "王大帅",
                                "display_name_local_script": "王大帅",
                                "display_name_western_script": "王大帅"
                            },
                            "relationship": {
                                "enum_name": "parent",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "gender": {
                                "enum_name": "male",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "date_of_birth": "2020-01-01",
                            "nationality_id_v2": "6862995745046267401",
                            "national_id_list": [
                                {
                                    "national_id_type_id": "6863330041896371725",
                                    "national_id_number": "1231131333",
                                    "issue_date": "2020-04-01",
                                    "expiration_date": "2020-05-21",
                                    "country_region_id": "6862995757234914824",
                                    "issued_by": "北京市公安局",
                                    "custom_fields": [
                                        {
                                            "custom_api_name": "name",
                                            "name": {
                                                "zh_cn": "自定义姓名",
                                                "en_us": "Custom Name"
                                            },
                                            "type": 1,
                                            "value": "\"231\""
                                        }
                                    ]
                                }
                            ],
                            "spouses_working_status": {
                                "enum_name": "example",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "is_this_person_covered_by_health_insurance": true,
                            "is_this_person_allowed_for_tax_deduction": false,
                            "custom_fields": [
                                {
                                    "custom_api_name": "name",
                                    "name": {
                                        "zh_cn": "自定义姓名",
                                        "en_us": "Custom Name"
                                    },
                                    "type": 1,
                                    "value": "\"231\""
                                }
                            ],
                            "dependent_name": "张三",
                            "employer": "海淀区交警大队",
                            "job": "保安",
                            "phone": {
                                "international_area_code": {
                                    "enum_name": "86_china",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "phone_number": "010-12345678",
                                "formatted_phone_number": "+86 010-12345678",
                                "device_type": {
                                    "enum_name": "mobile_phone",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "phone_usage": {
                                    "enum_name": "home",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "is_primary": true,
                                "is_public": true
                            },
                            "address": {
                                "full_address_local_script": "中国北京北京",
                                "full_address_western_script": "Beijing, Beijing, China,",
                                "address_id": "6989822217869624863",
                                "country_region_id": "6862995757234914824",
                                "region_id": "6863326815667095047",
                                "city_id": "6863333254578046471",
                                "distinct_id": "6863333516579440141",
                                "city_id_v2": "6863333254578046471",
                                "district_id_v2": "6863333516579440141",
                                "address_line1": "丹佛测试地址-纽埃时区",
                                "address_line2": "PoewH",
                                "address_line3": "PoewH",
                                "address_line4": "jmwJc",
                                "address_line5": "jmwJc",
                                "address_line6": "jmwJc",
                                "address_line7": "jmwJc",
                                "address_line8": "rafSu",
                                "address_line9": "McPRG",
                                "local_address_line1": "丹佛测试地址-纽埃时区",
                                "local_address_line2": "PoewH",
                                "local_address_line3": "PoewH",
                                "local_address_line4": "jmwJc",
                                "local_address_line5": "jmwJc",
                                "local_address_line6": "jmwJc",
                                "local_address_line7": "jmwJc",
                                "local_address_line8": "rafSu",
                                "local_address_line9": "McPRG",
                                "postal_code": "611530",
                                "address_type_list": [
                                    {
                                        "enum_name": "home_address",
                                        "display": [
                                            {
                                                "lang": "zh-CN",
                                                "value": "中文示例"
                                            }
                                        ]
                                    }
                                ],
                                "is_primary": true,
                                "is_public": true,
                                "custom_fields": [
                                    {
                                        "custom_api_name": "name",
                                        "name": {
                                            "zh_cn": "自定义姓名",
                                            "en_us": "Custom Name"
                                        },
                                        "type": 1,
                                        "value": "\"231\""
                                    }
                                ]
                            },
                            "birth_certificate_of_child": [
                                {
                                    "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200",
                                    "name": "document.txt"
                                }
                            ]
                        }
                    ],
                    "emergency_contact_list": [
                        {
                            "id": "123",
                            "name": {
                                "local_primary": "黄",
                                "local_first_name": "四",
                                "country_region_id": "6862995757234914824",
                                "name_type": {
                                    "enum_name": "legal_name",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "local_first_name_2": "五",
                                "local_primary_2": "王",
                                "additional_name": "别名",
                                "additional_name_type": {
                                    "enum_name": "legal_name",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "first_name": "帅",
                                "full_name": "王大帅",
                                "hereditary": "王",
                                "custom_name": "王大帅",
                                "custom_local_name": "王大帅",
                                "middle_name": "大",
                                "name_primary": "王",
                                "secondary": "王",
                                "tertiary": "王",
                                "social": {
                                    "enum_name": "example",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "title": {
                                    "enum_name": "example",
                                    "display": [
                                        {
                                            "lang": "zh-CN",
                                            "value": "中文示例"
                                        }
                                    ]
                                },
                                "local_middle_name": "大",
                                "local_secondary": "王",
                                "display_name_local_and_western_script": "王大帅",
                                "display_name_local_script": "王大帅",
                                "display_name_western_script": "王大帅"
                            },
                            "relationship": {
                                "enum_name": "parent",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "phone_ist": [
                                {
                                    "international_area_code": {
                                        "enum_name": "86_china",
                                        "display": [
                                            {
                                                "lang": "zh-CN",
                                                "value": "中文示例"
                                            }
                                        ]
                                    },
                                    "phone_number": "010-12345678",
                                    "formatted_phone_number": "+86 010-12345678",
                                    "device_type": {
                                        "enum_name": "mobile_phone",
                                        "display": [
                                            {
                                                "lang": "zh-CN",
                                                "value": "中文示例"
                                            }
                                        ]
                                    },
                                    "phone_usage": {
                                        "enum_name": "home",
                                        "display": [
                                            {
                                                "lang": "zh-CN",
                                                "value": "中文示例"
                                            }
                                        ]
                                    },
                                    "is_primary": true,
                                    "is_public": true
                                }
                            ],
                            "phone_list": [
                                {
                                    "international_area_code": {
                                        "enum_name": "86_china",
                                        "display": [
                                            {
                                                "lang": "zh-CN",
                                                "value": "中文示例"
                                            }
                                        ]
                                    },
                                    "phone_number": "010-12345678",
                                    "formatted_phone_number": "+86 010-12345678",
                                    "device_type": {
                                        "enum_name": "mobile_phone",
                                        "display": [
                                            {
                                                "lang": "zh-CN",
                                                "value": "中文示例"
                                            }
                                        ]
                                    },
                                    "phone_usage": {
                                        "enum_name": "home",
                                        "display": [
                                            {
                                                "lang": "zh-CN",
                                                "value": "中文示例"
                                            }
                                        ]
                                    },
                                    "is_primary": true,
                                    "is_public": true
                                }
                            ],
                            "legal_name": "张三",
                            "custom_fields": [
                                {
                                    "custom_api_name": "name",
                                    "name": {
                                        "zh_cn": "自定义姓名",
                                        "en_us": "Custom Name"
                                    },
                                    "type": 1,
                                    "value": "\"231\""
                                }
                            ],
                            "address": {
                                "full_address_local_script": "中国北京北京",
                                "full_address_western_script": "Beijing, Beijing, China,",
                                "address_id": "6989822217869624863",
                                "country_region_id": "6862995757234914824",
                                "region_id": "6863326815667095047",
                                "city_id": "6863333254578046471",
                                "distinct_id": "6863333516579440141",
                                "city_id_v2": "6863333254578046471",
                                "district_id_v2": "6863333516579440141",
                                "address_line1": "丹佛测试地址-纽埃时区",
                                "address_line2": "PoewH",
                                "address_line3": "PoewH",
                                "address_line4": "jmwJc",
                                "address_line5": "jmwJc",
                                "address_line6": "jmwJc",
                                "address_line7": "jmwJc",
                                "address_line8": "rafSu",
                                "address_line9": "McPRG",
                                "local_address_line1": "丹佛测试地址-纽埃时区",
                                "local_address_line2": "PoewH",
                                "local_address_line3": "PoewH",
                                "local_address_line4": "jmwJc",
                                "local_address_line5": "jmwJc",
                                "local_address_line6": "jmwJc",
                                "local_address_line7": "jmwJc",
                                "local_address_line8": "rafSu",
                                "local_address_line9": "McPRG",
                                "postal_code": "611530",
                                "address_type_list": [
                                    {
                                        "enum_name": "phone_type",
                                        "display": [
                                            {
                                                "lang": "zh-CN",
                                                "value": "中文示例"
                                            }
                                        ]
                                    }
                                ],
                                "is_primary": true,
                                "is_public": true,
                                "custom_fields": [
                                    {
                                        "custom_api_name": "name",
                                        "name": {
                                            "zh_cn": "自定义姓名",
                                            "en_us": "Custom Name"
                                        },
                                        "type": 1,
                                        "value": "\"231\""
                                    }
                                ]
                            }
                        }
                    ],
                    "date_entered_workforce": "2020-10-01",
                    "working_years": 2,
                    "profile_image_id": "dfysuc8x76dsfsw",
                    "email_address": "test@163.com",
                    "age": 22,
                    "highest_level_of_education": {
                        "school": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ],
                        "level_of_education": {
                            "enum_name": "phd",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "start_date": "2011-09-01",
                        "end_date": "2015-06-30",
                        "field_of_study": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ],
                        "degree": {
                            "enum_name": "phd",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "school_name": {
                            "enum_name": "example",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "field_of_study_name": {
                            "enum_name": "example",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "country_region_id": "1",
                        "expected_end_date": "2011-09-01",
                        "custom_fields": [
                            {
                                "custom_api_name": "name",
                                "name": {
                                    "zh_cn": "自定义姓名",
                                    "en_us": "Custom Name"
                                },
                                "type": 1,
                                "value": "\"231\""
                            }
                        ]
                    },
                    "highest_degree_of_education": {
                        "school": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ],
                        "level_of_education": {
                            "enum_name": "phd",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "start_date": "2011-09-01",
                        "end_date": "2015-06-30",
                        "field_of_study": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ],
                        "degree": {
                            "enum_name": "phd",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "school_name": {
                            "enum_name": "example",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "field_of_study_name": {
                            "enum_name": "exmple",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "country_region_id": "1",
                        "expected_end_date": "2011-09-01",
                        "custom_fields": [
                            {
                                "custom_api_name": "name",
                                "name": {
                                    "zh_cn": "自定义姓名",
                                    "en_us": "Custom Name"
                                },
                                "type": 1,
                                "value": "\"231\""
                            }
                        ]
                    },
                    "personal_profile": [
                        {
                            "personal_profile_type": {
                                "enum_name": "example",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "files": [
                                {
                                    "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200",
                                    "name": "document.txt"
                                }
                            ]
                        }
                    ],
                    "native_region": "6863326262618752111",
                    "hukou_type": {
                        "enum_name": "local_urban_residence",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "hukou_location": "山东省平阴县",
                    "political_affiliations": [
                        {
                            "enum_name": "communist_party_of_china",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        }
                    ],
                    "talent_id": "6863326262618752123",
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ],
                    "national_id_number": "11010000000000",
                    "family_address": "6863326262618752123",
                    "born_country_region": "中国",
                    "is_disabled": true,
                    "disable_card_number": "1110000",
                    "is_martyr_family": true,
                    "martyr_card_number": "1110000",
                    "is_old_alone": true,
                    "resident_taxes": [
                        {
                            "year_resident_tax": "2023",
                            "resident_status": {
                                "enum_name": "example",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "tax_country_region_id": "中国",
                            "custom_fields": [
                                {
                                    "field_name": "name",
                                    "value": "Sandy"
                                }
                            ]
                        }
                    ],
                    "first_entry_time": "2021-01-02",
                    "leave_time": "2022-01-02",
                    "religion": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "working_years_v2": 2.1
                },
                "custom_fields": [
                    {
                        "custom_api_name": "name",
                        "name": {
                            "zh_cn": "自定义姓名",
                            "en_us": "Custom Name"
                        },
                        "type": 1,
                        "value": "\"231\""
                    }
                ],
                "noncompete_status": {
                    "enum_name": "example",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "past_offboarding": true,
                "regular_employee_start_date": "2020-01-01",
                "external_id": "10000000",
                "times_employed": 16,
                "recruitment_type": {
                    "enum_name": "example",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "avatar_url": "https://internal-api-lark-file.feishu-boe.cn/static-resource/v1/v2_a550d36b-28ef-48ad-9e50-58004beb386j~?image_size=noop&cut_type=&quality=&format=png&sticker_format=.webp",
                "primary_contract_id": "7164286667866966659",
                "contract_start_date": "2020-01-01",
                "contract_end_date": "2020-01-01",
                "contract_expected_end_date": "2020-01-01",
                "pay_group_id": "7164286667866966659",
                "assignment_pay_group_id": "7164286667866966659",
                "international_assignment": true,
                "work_calendar_id": "7164286667866966659",
                "department": {
                    "id": "4719456877659520852",
                    "id_v2": "4719456877659520852",
                    "department_name": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "direct_manager": {
                    "employment_id": "6893014062142064135",
                    "employment_id_v2": "6893014062142064135",
                    "employee_number": "1000000",
                    "email_address": "test@163.com",
                    "person_info": {
                        "person_id": "6919733936050406926",
                        "preferred_name": "刘梓新",
                        "preferred_local_full_name": "刘梓新",
                        "preferred_english_full_name": "Henry"
                    }
                },
                "dotted_line_manager": {
                    "employment_id": "6893014062142064135",
                    "employment_id_v2": "6893014062142064135",
                    "employee_number": "1000000",
                    "email_address": "test@163.com",
                    "person_info": {
                        "person_id": "6919733936050406926",
                        "preferred_name": "刘梓新",
                        "preferred_local_full_name": "刘梓新",
                        "preferred_english_full_name": "Henry"
                    }
                },
                "time_zone": "Asia/Shanghai",
                "service_company": "7174374910734141112",
                "compensation_type": {
                    "enum_name": "example",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "work_shift": {
                    "enum_name": "example",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "custom_org": "{\"custom_org_02\":[{\"id\":\"1\",\"rate\":\"99\"}]}",
                "seniority_adjust_information_list": [
                    {
                        "seniority_adjustment_type": {
                            "enum_name": "phone_type",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "start_date": "2024-01-01",
                        "end_date": "2024-10-01",
                        "seniority_adjustment": 1.01,
                        "reasons_for_seniority_adjustment": "工厂停产需要减去半年工龄",
                        "custom_fields": [
                            {
                                "custom_api_name": "name",
                                "name": {
                                    "zh_cn": "自定义姓名",
                                    "en_us": "Custom Name"
                                },
                                "type": 1,
                                "value": "\"231\""
                            }
                        ]
                    }
                ],
                "employment_direct_bps": {
                    "hrbp_ids": [
                        "6863326262618752123"
                    ],
                    "location_bp_ids": [
                        "6863326262618752123"
                    ]
                },
                "employment_all_bps": {
                    "hrbp_ids": [
                        "6863326262618752123"
                    ],
                    "location_bp_ids": [
                        "6863326262618752123"
                    ]
                },
                "contract_type": {
                    "enum_name": "phone_type",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "archive_cpst_plan_id": "123456789"
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1160102	Param is invalid	参数错误，请检查入参
403	1160104	No authority error: 无权限的id 列表	对当前查询员工没有权限，请检查员工数据范围配置