# Get talent details

Obtain talent information according to talent ID.

**Notice**：At present, it is not supported to inquire about the details of deleted talents.

## Request

Facts | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/hire/v2/talents/:talent_id
HTTP Method | GET
Rate Limit | [20 per second](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
Supported app types | Custom App、Store App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.**<br>Enable any scope from the list | Obtain talent information(hire:talent:readonly)<br>Update talent information(hire:talent)
Required field scopes | **Notice**：The response body of the API contains the following sensitive fields, and they will be returned only after corresponding scopes are added. If you do not need the fields, it is not recommended that you request the scopes.<br>Obtain notes on recruitment(hire:note:readonly)<br>Obtain talent pool info(hire:talent_folder:readonly)<br>Update talent tag(hire:talent_tag)<br>Get talent tag(hire:talent_tag:readonly)<br>View talent blocklist(hire:talent_blocklist:readonly)<br>Update talent pool information(hire:talent_folder)<br>Update notes on recruitment(hire:note)<br>Obtain user ID(contact:user.employee_id:readonly)<br>Update talent blocklist(hire:talent_blocklist)

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `tenant_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[How to choose and get access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)

### Path parameters

Parameter | Type | Description
---|---|---
talent_id | string | Talent ID<br>**Example value**: "6960663240925956555"

### Query parameters

Parameter | Type | Required | Description
---|---|---|---
user_id_type | string | No | User ID categories<br>**Example value**: open_id<br>**Optional values are**:<br>- open_id：Identifies a user to an app. The same user has different Open IDs in different apps. [How to get Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)<br>- union_id：Identifies a user to a tenant that acts as a developer. A user has the same Union ID in apps developed by the same developer, and has different Union IDs in apps developed by different developers. A developer can use Union ID to link the same user's identities in multiple apps.[How to get Union ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id)<br>- user_id：Identifies a user to a tenant. The same user has different User IDs in different tenants. In one single tenant, a user has the same User ID in all apps （including store apps）. User ID is usually used to communicate user data between different apps. [How to get User ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)<br>- people_admin_id：Identify users by people_admin_id<br>**Default value**: `people_admin_id`<br>**When the value is `user_id`, the following field scopes are required**:<br>Obtain user ID(contact:user.employee_id:readonly)

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | composite_talent | \-
talent_id | string | ID
basic_info | composite_talent_basic_info | Basic information
name | string | name
mobile_number | string | mobile
mobile_code | string | Mobile country code
email | string | Email
experience_years | int | Working years
age | int | age
nationality_code | string | nationality
gender | int | Gender<br>**Optional values are**:<br>- 1：Male<br>- 2：Female<br>- 3：Secret
current_location_code | string | Location
hometown_location_code | string | hometown
preferred_location_code_list | string\[\] | Intentional place
home_address | string | home address
identification_type | int | Document type<br>**Optional values are**:<br>- 1：China - Resident ID Card<br>- 2：passport<br>- 3：China-Hong Kong and Macau Residence Permit<br>- 4：Mainland Travel Permit for China-Taiwan Residents<br>- 5：other<br>- 6：Mainland Travel Permit for Hong Kong and Macao Residents<br>- 9：China-Taiwan Residence Permit
identification_number | string | ID number
birthday | int | birthday
marital_status | int | Marital status<br>**Optional values are**:<br>- 1：Married<br>- 2：unmarried
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
hukou_location_code | string | hukou location
update_time | string | Talent update time, millisecond timestamp
create_time | string | Talent creation time, millisecond timestamp
confidential | int | Talent Hidden State<br>**Optional values are**:<br>- 1：hide<br>- 2：public
education_list | composite_talent_education_info\[\] | Educational experience
degree | int | Degree<br>**Optional values are**:<br>- 1：Primary school<br>- 2：Junior middle school<br>- 3：Vocational high school<br>- 4：Senior middle school<br>- 5：College degree<br>- 6：Bachelor degree<br>- 7：Master<br>- 8：Doctor<br>- 9：Other
school_name | string | School
major | string | Major
start_time | string | Start time
end_time | string | End time
education_type | int | Degree type<br>**Optional values are**:<br>- 1：Overseas and Hong Kong and Taiwan<br>- 2：Unified recruitment full-time<br>- 3：Part-time<br>- 4：Self exam<br>- 5：Other
academic_ranking | int | Academic ranking<br>**Optional values are**:<br>- 5：Top 5 percent<br>- 10：Top 10 percent<br>- 20：Top 20 percent<br>- 30：Top 30 percent<br>- 50：Top 50 percent<br>- -1：other
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
career_list | composite_talent_career_info\[\] | Work experience
company_name | string | company
description | string | describe
end_time | string | End time
start_time | string | Start time
title | string | professional title
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
project_list | composite_talent_project_info\[\] | Project expirence
project_name | string | Name
role | string | Role
link | string | Link
description | string | Describe
start_time | string | Start time
end_time | string | End time
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
works_list | composite_talent_works_info\[\] | Works
id | string | ID
link | string | Link
description | string | describe
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
award_list | composite_talent_award_info\[\] | List of winners
award_name | string | name
award_time | string | Award time
description | string | describe
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
language_list | composite_talent_language_info\[\] | Language List
language | int | Language<br>**Optional values are**:<br>- 1：English<br>- 2：French<br>- 3：Japanese<br>- 4：Korean<br>- 5：German<br>- 6：Russian<br>- 7：Spanish<br>- 8：Portuguese<br>- 9：Arabic<br>- 10：Hindi<br>- 11：Hindustani<br>- 12：Bengali<br>- 13：Hausa<br>- 14：Punjabi<br>- 15：Persian<br>- 16：Swahili<br>- 17：Telugu<br>- 18：Turkish<br>- 19：Italian<br>- 20：Javanese<br>- 21：Tamil<br>- 22：Marathi<br>- 23：Vietnamese<br>- 24：Mandarin<br>- 25：Cantonese
proficiency | int | Skill level<br>**Optional values are**:<br>- 1：Elementary<br>- 2：LimitedWorking<br>- 3：ProfessionalWorking<br>- 4：FullProfessional<br>- 5：NativeOrBilingual
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
sns_list | composite_talent_sns_info\[\] | SNS list
sns_type | int | SNS type<br>**Optional values are**:<br>- 1：LinkedIn<br>- 2：Maimai<br>- 3：Wechat<br>- 4：Weibo<br>- 5：Github<br>- 6：Zhihu<br>- 7：Facebook<br>- 8：Twitter<br>- 9：Whatsapp<br>- 10：PersonalWebsite<br>- 11：QQ
link | string | SNS
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
resume_source_list | talent_resume_source\[\] | resume source
id | string | ID
zh_name | string | Chinese name
en_name | string | English name
internship_list | composite_talent_internship_info\[\] | Internship experience
company_name | string | company
description | string | describe
end_time | string | End time
start_time | string | Start time
title | string | professional title
customized_data_list | talent_customized_data_child\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is single, get the value from this field
key | string | Option ID
name | i18n | Option Name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-choice, get the value from this field
key | string | Option ID
name | i18n | Option Name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is time period, get the value from this field
start_time | string | Start time, second-level timestamp
end_time | string | End time, when the value is now, return 「-」, second-level timestamp
time | string | When the field type is date selection, month selection, or year selection, take the value from this field, which is a second-level timestamp
number | string | When the field type is a number, get the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is attachment, get the value from this field
file_id | string | Attachment ID
file_name | string | Attachment Name
content_type | string | Attachment type
file_size | int | Attachment Size
customized_data_list | composite_talent_customized_data\[\] | Custom Fields
module_id | string | Module ID
name | i18n | Module name
zh_cn | string | Chinese
en_us | string | English
object_type | int | type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module
children | talent_customized_data_child\[\] | Fields of module
object_id | string | Custom field ID
name | i18n | Field name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field type<br>**Optional values are**:<br>- 1：Single line text<br>- 2：multiline text<br>- 3：radio<br>- 4：multiple choice<br>- 5：date<br>- 6：Month selection<br>- 7：Year selection<br>- 8：time period<br>- 9：number<br>- 10：Default field<br>- 11：module<br>- 12：date<br>- 13：Annex
value | talent_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | talent_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
option_list | talent_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option name
zh_cn | string | Chinese
en_us | string | English
time_range | talent_customized_time_range | When the field type is Time Period, take the value from this field
start_time | string | Start time, seconds timestamp
end_time | string | End time, when the value is so far, returns "-", the second-level timestamp
time | string | When the field type is Date Select, Month Select, Year Select, take the value from this field, which is a second-level timestamp
number | string | When the field type is numeric, take the value from this field
customized_attachment | talent_customized_attachment\[\] | When the field type is Attachment, take the value from this field
file_id | string | Attachment ID
file_name | string | Attachment name
content_type | string | Attachment type
file_size | int | Attachment size
resume_attachment_id_list | string\[\] | Attachment id list
resume_attachment_list | talent_resume_attachment\[\] | List of resume attachments (in descending order according to resume creation time)
id | string | ID
name | string | Attachment name, including file type suffix, such as [resume.pdf]
mime | string | Attachment MIME type
create_time | string | Create time, millisecond timestamp
interview_registration_list | talent_interview_registration_simple\[\] | Registration Schema<br>**Notice**：You are recommended to obtain the full list of registration forms with the registration_list field
id | string | ID
registration_time | int | Create time
download_url | string | Download Link
registration_list | registration_basic_info\[\] | Registration form list
id | string | ID
registration_time | int | Create time
download_url | string | Download link
scenario | int | Registration form scene<br>**Optional values are**:<br>- 5：Interview registration form<br>- 6：Onboarding registration form<br>- 14：Information update registration form
is_onboarded | boolean | Is onboard<br>**Optional values are**:<br>- false：overboard<br>- true：onboard
is_in_agency_period | boolean | In agency protect<br>**Optional values are**:<br>- false：overboard<br>- true：onboard
top_degree | int | Degree type
talent_pool_id_list | string\[\] | folder list
talent_folder_ref_list_v2 | talent_folder\[\] | folder list<br>**Required field scopes (Satisfy any)**:<br>Obtain talent pool info(hire:talent_folder:readonly)<br>Update talent pool information(hire:talent_folder)
name | string | Folder name
folder_id | string | Folder ID
owner_id | string | Owner ID
add_time | string | Folder join time, millisecond timestamp
tag_list | talent_tag\[\] | tag list<br>**Required field scopes (Satisfy any)**:<br>Update talent tag(hire:talent_tag)<br>Get talent tag(hire:talent_tag:readonly)
id | string | Tag ID
name | i18n | label name
zh_cn | string | Label Chinese name
en_us | string | Label English name
description | i18n | label description
zh_cn | string | Label Chinese description
en_us | string | Label English description
type | int | label type<br>**Optional values are**:<br>- 1：manual label<br>- 2：Automatic labeling
similar_info_v2 | talent_similar | Talent blacklist information
is_similar_talent | boolean | Add blacklist time, millisecond timestamp
similar_talent_id_list | string\[\] | Blacklist creator ID, consistent with the input parameter `user_id_type`
block_info | talent_block | List of talent pools that talents have joined (the maximum return length of the list is 100, please check the `talent_pool_id_list` field if it is greater than 100)<br>**Required field scopes (Satisfy any)**:<br>Update talent blocklist(hire:talent_blocklist)<br>View talent blocklist(hire:talent_blocklist:readonly)
blocked_time | string | Add blacklist time, millisecond timestamp
creator_id | string | Blacklist creator ID, consistent with the input parameter `user_id_type`
reason | string | Reason for joining the blacklist
talent_pool_ref_list_v2 | talent_pool\[\] | Remarks list<br>**Required field scopes (Satisfy any)**:<br>Obtain talent pool info(hire:talent_folder:readonly)<br>Update talent pool information(hire:talent_folder)
id | string | Note ID
name | i18n | Talent ID
zh_cn | string | Talent pool Chinese name
en_us | string | Talent pool English name
description | i18n | Application ID
zh_cn | string | Talent pool Chinese description
en_us | string | Talent pool English name
add_time | string | Talent note creation time, millisecond timestamp
note_list_v2 | talent_note\[\] | comment list<br>**Required field scopes (Satisfy any)**:<br>Obtain notes on recruitment(hire:note:readonly)<br>Update notes on recruitment(hire:note)
id | string | Note ID
talent_id | string | Talent ID
application_id | string | Delivery ID, please check [Get Delivery Information] (/ssl: ttdoc/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get) for details.
create_time | string | Talent note creation time, millisecond timestamp
update_time | string | Talent note update time, millisecond timestamp
creator_id | string | Creator ID, the same type as imported parameter user_id_type
content | string | Remarks
privacy | int | Remarks Private Attribute<br>**Optional values are**:<br>- 1：Private<br>- 2：Public

### Response body example
```json
{"code":0,
"msg":"success",
"data":{"talent_id":"6761694410053798151",
"basic_info":{"name":"测试",
"mobile_number":"18312341234",
"mobile_code":"86",
"email":"16xx1@126.com",
"experience_years":5,
"age":22,
"nationality_code":"CN",
"gender":1,
"current_location_code":"CN_2",
"hometown_location_code":"CN_3",
"preferred_location_code_list":["CN_2"],
"home_address":"Chaoyang District, Beijing",
"identification_type":1,
"identification_number":"511699199x1x111234",
"birthday":293016767159,
"marital_status":1,
"customized_data_list":[{
    "object_id": "xxxx",
    "name": {
        "zh_cn": "测试",
        "en_us": "test"
    },
    "object_type": 1,
    "value": {
        "content": "text",
        "option": {
            "key": "AA",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            }
        },
        "option_list": [
            {
                "key": "AA",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                }
            }
        ],
        "time_range": {
            "start_time": "1625456721",
            "end_time": "1625656721"
        },
        "time": "1625456721",
        "number": "111",
        "customized_attachment": [
            {
                "file_id": "7140517838785481004",
                "file_name": "1.13测试1的面试记录.pdf",
                "content_type": "application/pdf",
                "file_size": 16615
            }
        ]
    }
}],
"hukou_location_code":"CN_1",
"update_time":"1634801678103",
"create_time":"1634801678103",
"confidential":1},
"education_list":[{
    "degree": 1,
    "school_name": "湘港大学",
    "major": "考古",
    "start_time": "1992-01",
    "end_time": "1994-01",
    "education_type": 1,
    "academic_ranking": 5,
    "customized_data_list": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"career_list":[{
    "company_name": "Tomorrow Technology",
    "description": "1688180087",
    "end_time": "1687180087",
    "start_time": "1655644087000",
    "title": "scientist",
    "customized_data_list": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"project_list":[{
    "project_name": "测试",
    "role": "test",
    "link": "www.recruitment-demo.com",
    "description": "Recruitment website",
    "start_time": "1990-01",
    "end_time": "1991-01",
    "customized_data_list": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"works_list":[{
    "id": "6891560630172518670",
    "link": "https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent/get-2",
    "description": "talent info page",
    "customized_data_list": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"award_list":[{
    "award_name": "最佳新人奖",
    "award_time": "1991",
    "description": "最优秀的新人奖",
    "customized_data_list": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"language_list":[{
    "language": 1,
    "proficiency": 1,
    "customized_data_list": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"sns_list":[{
    "sns_type": 1,
    "link": "1",
    "customized_data_list": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"resume_source_list":[{
    "id": "6891560630172518670",
    "zh_name": "猎头",
    "en_name": "Hunter"
}],
"internship_list":[{
    "company_name": "Tomorrow Technology",
    "description": "Tomorrow Technology Internship Company",
    "end_time": "1687180087000",
    "start_time": "1655644087000",
    "title": "Intern Scientist",
    "customized_data_list": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"customized_data_list":[{
    "module_id": "7106698109352479020",
    "name": {
        "zh_cn": "测试",
        "en_us": "test"
    },
    "object_type": 1,
    "children": [
        {
            "object_id": "xxxx",
            "name": {
                "zh_cn": "测试",
                "en_us": "test"
            },
            "object_type": 1,
            "value": {
                "content": "text",
                "option": {
                    "key": "AA",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "option_list": [
                    {
                        "key": "AA",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                ],
                "time_range": {
                    "start_time": "1625456721",
                    "end_time": "1625656721"
                },
                "time": "1625456721",
                "number": "111",
                "customized_attachment": [
                    {
                        "file_id": "7140517838785481004",
                        "file_name": "1.13测试1的面试记录.pdf",
                        "content_type": "application/pdf",
                        "file_size": 16615
                    }
                ]
            }
        }
    ]
}],
"resume_attachment_id_list":["64352523512563462"],
"resume_attachment_list":[{
    "id": "6891560630172518670",
    "name": "1. pdf",
    "mime": "Application/pdf",
    "create_time": "1734348840749"
}],
"interview_registration_list":[{
    "id": "6833685612520950030",
    "registration_time": 1618494330932,
    "download_url": "https://hire.feishu.cn/hire/file/blob/...token.../"
}],
"registration_list":[{
    "id": "6833685612520950030",
    "registration_time": 1618494330932,
    "download_url": "https://hire.feishu.cn/hire/file/blob/...token.../",
    "scenario": 5
}],
"is_onboarded":true,
"is_in_agency_period":true,
"top_degree":1,
"talent_pool_id_list":["7171693733661327361"],
"talent_folder_ref_list_v2":[{
    "name": "人才文件夹A1",
    "folder_id": "7041806543797995820",
    "owner_id": "ou_85bb308c57f597471cd2bb5b4f580245",
    "add_time": "1634801678103"
}],
"tag_list":[{
    "id": "7140517838785481004",
    "name": {
        "zh_cn": "Highly educated talents",
        "en_us": "985"
    },
    "description": {
        "zh_cn": "This is a label.",
        "en_us": "This is a english tag"
    },
    "type": 1
}],
"similar_info_v2":{"is_similar_talent":1625656721,
"similar_talent_id_list":["6891560630172518670"]},
"block_info":{"blocked_time":"1625656721",
"creator_id":"6891560630172518670",
"reason":"Talent cheating
"},
"talent_pool_ref_list_v2":[{
    "id": "6949805467799537964",
    "name": {
        "zh_cn": "测试",
        "en_us": "test"
    },
    "description": {
        "zh_cn": "测试",
        "en_us": "test"
    },
    "add_time": "1618209327096"
}],
"note_list_v2":[{
    "id": "6949805467799537964",
    "talent_id": "6916472453069883661",
    "application_id": "6891565253964859661",
    "create_time": "1618209327096",
    "update_time": "1618209327096",
    "creator_id": "ou_f476cb099ac9227c9bae09ce46112579",
    "content": "测试备注内容",
    "privacy": 1
}]}}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
500 | 1002001 | system error | Contact R & D to investigate
404 | 1002102 | talent not exist | Please check if talent exists
400 | 1002002 | Parameter illegal | Please check that the parameter format is correct

