# List interview records Obtain interview evaluation details in batches. The returned results are sorted by ID by default. ## Request Facts |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/hire/v1/interview_records HTTP Method | GET Rate Limit | [10 per second](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) Supported app types | Custom App、Store App Required scopes
**To use this API, you must have at least 1 of the listed scopes.**
Enable any scope from the list | Obtain interview information(hire:interview:readonly)
Update interview information(hire:interview) 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.
Obtain user ID(contact:user.employee_id:readonly) ### Request header Parameter | Type | Required | Description ---|---|---|--- Authorization | string | Yes | `tenant_access_token`
**Value format**: "Bearer `access_token`"
**Example value**: "Bearer t-7f1bcd13fc57d46bac21793a18e560"
[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) ### Query parameters Parameter | Type | Required | Description ---|---|---|--- page_size | int | No | paging size
**Example value**: 10
**Default value**: `10`
**Data validation rules**:
- Maximum value: `100` page_token | string | No | Page identifier. It is not filled in the first request, indicating traversal from the beginning; when there will be more groups, the new page_token will be returned at the same time, and the next traversal can use the page_token to get more groups
**Example value**: eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= ids | string\[\] | No | List of interview feedback IDs, not paginated when using this filter
**Example value**: 6930815272790114324
**Data validation rules**:
- Maximum length: `100` user_id_type | string | No | User ID categories
**Example value**: open_id
**Optional values are**:
- 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)
- 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)
- 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)
**Default value**: `open_id`
**When the value is `user_id`, the following field scopes are required**:
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 | \- | \- items | interview_record\[\] | List of interview feedback details id | string | Review ID user_id | string | Interviewer User ID content | string | Interview record content commit_status | int | commit status
**Optional values are**:
- 1：Submitted
- 2：Not submitted feedback_submit_time | int | Interview feedback submission time conclusion | int | Interview conclusion
**Optional values are**:
- 1：passed
- 2：failed
- 3：Not started
- 4：Not submitted
- 5：Not present
- 6：to be determined interview_score | interview_score | interview score id | string | Interview score ID level | int | score level zh_name | string | Chinese name zh_description | string | Chinese description en_name | string | English name en_description | string | English description assessment_score | assessment_score_info | Face-to-face grading question score calculate_type | int | scoring method
**Optional values are**:
- 1：total score
- 2：average score score | number(float) | Fractions (accurate to two decimal places) full_score | int | full score question_list | interview_question\[\] | Interview questions id | string | Interview Question ID title | i18n | Interview questions zh_cn | string | Have you ever encountered a situation where team members did not meet their goals? en_us | string | Have you ever encountered a situation where a team member did not meet their goals? description | i18n | Interview question description zh_cn | string | Interview Questions Chinese Description en_us | string | What was the specific situation at that time? content | string | The content of the interviewer's answer ability_list | ability\[\] | Topic related competencies id | string | Ability item ID name | i18n | Ability item name zh_cn | string | Ability item Chinese name en_us | string | English name of ability item description | i18n | Ability item description zh_cn | string | Ability item Chinese description en_us | string | Ability item description in English code_question_list | interview_question\[\] | Online programming topics id | string | Interview Question ID title | i18n | Interview questions zh_cn | string | Have you ever encountered a situation where team members did not meet their goals? en_us | string | Have you ever encountered a situation where a team member did not meet their goals? description | i18n | Interview question description zh_cn | string | Interview Questions Chinese Description en_us | string | What was the specific situation at that time? content | string | The content of the interviewer's answer interviewer | id_name_object | Interviewer information id | string | ID name | i18n | name zh_cn | string | Chinese en_us | string | English image_list | attachment_v2\[\] | Interview feedback pictures id | string | Attachment ID url | string | Attached url name | string | Attachment file name mime | string | MIME type create_time | string | Attachment creation time (ms) dimension_assessment_list | interview_dimension_assessment\[\] | Interview dimension evaluation information id | string | Dimension Evaluation ID name | i18n | Dimension name zh_cn | string | Chinese en_us | string | English full_score | int | The total score of the scoring questions is only available when the question type is "scoring questions (single choice) " and "scoring questions (fill in the blanks) " content | string | When the dimension evaluation method is "description question", take the value from this dimension_id | string | Dimension ID dimension_score | interview_dimension_score | When the dimension evaluation method is "Multiple Choice Question" "/Grading Question (Single Choice) ", the value is taken from this id | string | Option ID name | i18n | Option name zh_cn | string | Chinese en_us | string | English score_val | int | The score corresponding to the option, the dimension is evaluated as the method "Scored Questions (Radio Choice) " Follow this field dimension_score_list | interview_dimension_score\[\] | When the dimension evaluation method is "multiple-select question", take this value id | string | Option ID name | i18n | Option name zh_cn | string | Chinese en_us | string | English dimension_custom_score | int | When the dimension evaluation method is "scoring questions (fill in the blanks) ", take the value from this ability_list | ability\[\] | Dimensional correlation ability item id | string | Ability item ID name | i18n | Ability item name zh_cn | string | Ability item Chinese name en_us | string | English name of ability item description | i18n | Ability item description zh_cn | string | Ability item Chinese description en_us | string | Ability item description in English question_list | interview_question\[\] | Dimensional relevance interview questions id | string | Interview Question ID title | i18n | Interview questions zh_cn | string | Have you ever encountered a situation where team members did not meet their goals? en_us | string | Have you ever encountered a situation where a team member did not meet their goals? description | i18n | Interview question description zh_cn | string | Interview Questions Chinese Description en_us | string | What was the specific situation at that time? content | string | The content of the interviewer's answer ability_list | ability\[\] | Topic related competencies id | string | Ability item ID name | i18n | Ability item name zh_cn | string | Ability item Chinese name en_us | string | English name of ability item description | i18n | Ability item description zh_cn | string | Ability item Chinese description en_us | string | Ability item description in English dimension_type | int | Dimensional evaluation method
**Optional values are**:
- 1：Multiple choice question
- 2：Multiple-select question
- 3：Description question
- 4：Single line text
- 5：Rank range
- 6：Grading questions (Single Choice)
- 7：Grading questions (fill in the blanks)
- 10：System default question - conclusion
- 11：System default question - score
- 12：System default title - tecord page_token | string | Page identifier, when has_more is true, a new page_token will also be returned. Otherwise, page_token will not be returned has_more | boolean | Whether the response body has more parameters ### Response body example ```json { "code": 0, "msg": "success", "data": { "items": [ { "id": "6949805467799537964", "user_id": "1618899376474", "content": "代码还行，只是不够聪明", "commit_status": 1, "feedback_submit_time": 1659318415000, "conclusion": 1, "interview_score": { "id": "6949805467799537964", "level": 3, "zh_name": "3", "zh_description": "通过, 能力达到要求, 建议录用", "en_name": "three", "en_description": "Pass, ability to meet the requirements, suggest to hire" }, "assessment_score": { "calculate_type": 1, "score": 1, "full_score": 100 }, "question_list": [ { "id": "7270798542321666367", "title": { "zh_cn": "测试", "en_us": "test" }, "description": { "zh_cn": "当时具体是什么情况？", "en_us": "test" }, "content": "没有", "ability_list": [ { "id": "7270798542321666366", "name": { "zh_cn": "创新思维", "en_us": "Creative Thinking" }, "description": { "zh_cn": "创新思维", "en_us": "Creative Thinking" } } ] } ], "code_question_list": [ { "id": "7270798542321666367", "title": { "zh_cn": "测试", "en_us": "test" }, "description": { "zh_cn": "当时具体是什么情况？", "en_us": "test" }, "content": "没有" } ], "interviewer": { "id": "ou_bc6dd7d30630700f443193d602841086", "name": { "zh_cn": "测试", "en_us": "test" } }, "image_list": [ { "id": "7270798542321666364", "url": "https://open.feishu.cn/hire/file/blob/xxxx/", "name": "成绩单", "mime": "image/jpg", "create_time": "1693884103327" } ], "dimension_assessment_list": [ { "id": "6949805467799537964", "name": { "zh_cn": "测试", "en_us": "test" }, "full_score": 100, "content": "这个候选人还不错", "dimension_id": "11111111", "dimension_score": { "id": "6949805467799537964", "name": { "zh_cn": "测试", "en_us": "test" }, "score_val": 10 }, "dimension_score_list": [ { "id": "6949805467799537964", "name": { "zh_cn": "测试", "en_us": "test" } } ], "dimension_custom_score": 10, "ability_list": [ { "id": "7270798542321666366", "name": { "zh_cn": "创新思维", "en_us": "Creative Thinking" }, "description": { "zh_cn": "创新思维", "en_us": "Creative Thinking" } } ], "question_list": [ { "id": "7270798542321666367", "title": { "zh_cn": "测试", "en_us": "test" }, "description": { "zh_cn": "当时具体是什么情况？", "en_us": "test" }, "content": "没有", "ability_list": [ { "id": "7270798542321666366", "name": { "zh_cn": "创新思维", "en_us": "Creative Thinking" }, "description": { "zh_cn": "创新思维", "en_us": "Creative Thinking" } } ] } ], "dimension_type": 1 } ] } ], "page_token": "eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0=", "has_more": true } } ``` ### Error code HTTP status code | Error code | Description | Troubleshooting suggestions ---|---|---|--- 500 | 1002001 | System error | Please locate according to the actual error information or Or [consult customer service](https://applink.feishu.cn/client/helpdesk/open?id=6626260912531570952&extra=%7B%22channel%22:14,%22created_at%22:1614493146,%22scenario_id%22:6885151765134622721,%22signature%22:%22ca94c408b966dc1de2083e5bbcd418294c146e98%22%7D)) 400 | 1002002 | Parameter error | Check if the parameters are correct, such as type, size For more information on error codes, see [Generic Error Code](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN).