# Get the applications that users commonly use

Get the applications that users commonly use

## Request

Facts |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/application/v5/applications/favourite
HTTP Method | GET
Rate Limit | [1000 per minute、50 per second](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
Supported app types | Custom App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.** | Obtain apps information(admin:app.info:readonly)

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `user_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer u-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)

### Query parameters

Parameter | Type | Required | Description
---|---|---|---
language | string | No | Language version of application information<br>**Example value**: "zh_cn"<br>**Optional values are**:<br>- zh_cn：Chinese<br>- en_us：English<br>- ja_jp：Japanese
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<br>**Example value**: "new-e11ee058b4a8ed2881da11ac7e37c4fc"
page_size | int | No | Page size<br>**Example value**: 10<br>**Default value**: `10`

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-
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
total_count | int | TotalCount
has_more | boolean | Whether the response body has more parameters
app_list | application\[\] | Application data list
app_id | string | Application ID
app_name | string | Application Name
description | string | Description
app_type | string | Application Type<br>**Optional values are**:<br>- app：general application<br>- shortcut：Quick Entry
avatar_url | string | Application Icons
open_methods | open_method\[\] | Open method
type | string | Applink type<br>**Optional values are**:<br>- mobile_gadget：Mobile end Mini Program<br>- mobile_web：Mobile end Web<br>- pc_gadget：PC Mini Program<br>- pc_web：PC side web<br>- bot：Robot
applink | string | Applink link

### Response body example
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "page_token": "new-e11ee058b4a8ed2881da11ac7e37c4fc",
        "total_count": 7,
        "has_more": false,
        "app_list": [
            {
                "app_id": "cli_9f9f8825d53xxxx",
                "app_name": "Efficiency Tools",
                "description": "An application to enhance office efficiency",
                "app_type": "app",
                "avatar_url": "Https://s1-xxxxxx/static-resource/v1/ca597e6e-28c1-4178-961a-1xxxxx",
                "open_methods": [
                    {
                        "type": "mobile_gadget",
                        "applink": "https://applink.feishu.cn/client/web_app/open?appId=cli_9f9f8825d53xxxx"
                    }
                ]
            }
        ]
    }
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
400 | 213001 | user_id is invalid | Check that user identity information is correct
400 | 213002 | page_size is invalid | Please check if page_size range is within the specified range
400 | 213003 | page_token is invalid | page_token not interoperable between applications, check if the page_token is obtained by the application calling the interface
400 | 213004 | request param is invalid | Check if the request parameters are legal
400 | 213005 | get favourite apps fail | Internal server error, please contact  [technical support](https://applink.feishu.cn/TLJpeNdW)
409 | 213007 | get apps detail fail | Internal server error, please contact [technical support](https://applink.feishu.cn/TLJpeNdW)
409 | 213008 | get visibility fail | Internal server error, please contact  [technical support](https://applink.feishu.cn/TLJpeNdW)