# Get application information

Get application by application ID.

## Request

Facts | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/hire/v1/applications/:application_id
HTTP Method | GET
Rate Limit | [1000 per minute & 50 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 | Update application information (hire:application)<br>Obtain application information(hire:application:readonly)
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 user ID(contact:user.employee_id:readonly)

### 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
---|---|---
application_id | string | Application ID<br>**Example value**: "212121"

### 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>**Default value**: `open_id`<br>**When the value is `user_id`, the following field scopes are required**:<br>Obtain user ID(contact:user.employee_id:readonly)
options | string\[\] | No | Request control parameters to control the interface response logic.<br>If you need to query multiple user IDs at once, you can pass the same parameter name multiple times, each time with a different parameter value. For example: https://{url}?options={option1}&options={option2}.<br>**Example value**: get_latest_application_on_chain<br>**Optional values are**:<br>- get_latest_application_on_chain：Only effective for virtual job applications.<br>- If the application is not assigned, the virtual job application is considered the latest application. The information of the specified virtual job application in the request will be returned.<br>- If the application is assigned, it will return the information of the latest real job application on the assignment chain, not the specified application in the request.

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-
application | application | Application data
id | string | Application id
job_id | string | Post id
talent_id | string | Candidate id
resume_source_id | string | Resume source ID
stage | application_stage_info | The stage of delivery
id | string | Stage id
zh_name | string | Stage Chinese name
en_name | string | English name
type | int | Stage type<br>**Optional values are**:<br>- 1：Filter type<br>- 2：Evaluation type<br>- 3：Written test<br>- 4：Interview type<br>- 5：Offer type<br>- 6：Pending entry<br>- 7：Enrolled<br>- 8：Other types<br>- 255：System default
active_status | int | Active state<br>**Optional values are**:<br>- 1：Active<br>- 2：Inactive, equals to "terminated"
delivery_type | int | Delivery Type,Please refer [「Enum constant」](https://open.larkoffice.com/document/server-docs/hire-v1/enum?lang=en-US) - delivery type to the detailed enumeration<br>**Optional values are**:<br>- 1：HR search<br>- 2：Candidate active delivery
resume_source_info | application_resume_source | Delivery source information
id | string | Delivery Source ID
name | i18n | Delivery source name
zh_cn | string | Chinese
en_us | string | English
resume_source_type | int | Delivery Source Type<br>**Optional values are**:<br>- 10000：Referral<br>- 10001：Headhunters<br>- 10002：Internal sources<br>- 10003：Third-party recruitment website<br>- 10004：Social media<br>- 10005：Offline source<br>- 10006：Other<br>- 10007：External recommendation<br>- 10008：Employee transfer<br>- 10009：Intern Turned Regular
website_resume_source | application_website_resume_source | Website delivery source
website_id | string | Official Website Site ID
website_name | i18n | Official Website Site Name
zh_cn | string | Chinese
en_us | string | English
channel | application_website_channel | Promotion channel source
channel_id | string | Website Promotion Channel ID
channel_name | i18n | Official website promotion channel name
zh_cn | string | Chinese
en_us | string | English
talent_attachment_resume_id | string | Resume attachment ID
create_time | string | Creation time
modify_time | string | Modify time
stage_time_list | application_stage_time\[\] | Stage change time list
stage_id | string | Phase ID
enter_time | string | The last time you entered this stage
exit_time | string | The last departure time, if it is currently at this stage, is empty
termination_type | int | Types of reasons for termination<br>**Optional values are**:<br>- 1：We rejected the candidate<br>- 22：The candidate rejected us<br>- 27：Other
termination_reason_list | string\[\] | The id list of the specific reason for termination
termination_reason_note | string | Termination note
application_preferred_city_list | code_name_object\[\] | List of cities of interest
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
creator_id | string | Application creator ID. Only available when the application creator is an employee of the company (e.g., employee manually uploads resume / joins a job / makes a referral). Otherwise, it returns empty (e.g., candidate makes an application)

### Response body example
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "application": {
            "id": "6949805467799537964",
            "job_id": "6843547872837273223",
            "talent_id": "6843547872837273223",
            "resume_source_id": "6583482347283472832",
            "stage": {
                "id": "614218419274131",
                "zh_name": "面试",
                "en_name": "Interview",
                "type": 1
            },
            "active_status": 1,
            "delivery_type": 1,
            "resume_source_info": {
                "id": "614218419274131",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                },
                "resume_source_type": 10002
            },
            "website_resume_source": {
                "website_id": "614218419274131",
                "website_name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                },
                "channel": {
                    "channel_id": "777218419274131",
                    "channel_name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                }
            },
            "talent_attachment_resume_id": "6960663240925956415",
            "create_time": "1632990774278",
            "modify_time": "1634801678103",
            "stage_time_list": [
                {
                    "stage_id": "614218419274131",
                    "enter_time": "1632991542615",
                    "exit_time": "1631509574398"
                }
            ],
            "termination_type": 1,
            "termination_reason_list": [
                "6942778198054125570"
            ],
            "termination_reason_note": "Other deliveries have been hired",
            "application_preferred_city_list": [
                {
                    "code": "1111",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                }
            ],
            "creator_id": "ou_ ce613028fe74745421f5dc320bb9c709"
        }
    }
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
500 | 1002001 | System error | Check if the imported parameters are valid
400 | 1002002 | Parameter illegal | Check that the imported parameter format is correct

