# Custom app API call limit

In order to improve service stability and user experience, the open platform will adjust the upper limit of the total number of API calls for custom apps in the free version of Feishu Basic.

## Adjustment content

For Basic Plan tenants, the combined API call limit for all custom apps is temporarily set to **1 million calls** for June 2026. This quota resets on the first day of each month.
**Note**:
For the Basic Plan, the combined API call limit for both unverified and verified organizations is temporarily set to 1 million calls for June 2026.

## Effective range

Dimension | Effective range
---|---
**[Feishu version](https://www.feishu.cn/service)** | Basic
**[App type](https://open.feishu.cn/document/home/app-types-introduction/overview)** | Custom app
**[OpenAPI](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/server-api-list)** | Except for the following table **OpenAPI** that does not count the call volume, all other OpenAPIs count the API call volume

For example, if a company is using the Basic Plan (with a temporary API call limit of 1 million in June 2026), and its custom apps make 30,000 calls from Custom App A and 100,000 calls from Custom App B during the month, the total number of API calls from custom apps is 130,000, leaving 870,000 calls available for the rest of the month.

### OpenAPI not included in the call volume

The following business APIs are not included in the monthly API call volume of the enterprise's custom apps. Even if the enterprise API call volume has been exhausted, these APIs can continue to be called. For example, if the enterprise API call volume is 9,000 times, and a custom app calls the [Create User](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create) interface of the address book 100 times, the enterprise API call volume is still 9,000 times.

- [Authentication and authorize](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/passport-v1/session/usum)
- [Event subscriptions](https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-v1/outbound_ip/list)
- [Contacts](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/resources)
- [Feishu CoreHR standard version](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/ehr/ehr-v1/employee/list)
- [Feishu CoreHR enterprise edition](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/overview)
- [Hire](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/recruitment-development-guide)
- [Performance](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v1/semester/list)
- [Smart access control](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/development-guide)
- [Feishu app engine](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/application-function/invoke)
- [AI](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/optical_char_recognition-v1/image/basic_recognize)
- [Aily](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/aily-v1/aily_session/create)
**Note**: If the above business API has a historical version, calling the historical version API will not occupy the enterprise's API call volume.

You can refer to the directory where the API document is located to confirm the business to which the API belongs. For example, the [Create User](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create) API belongs to the contacts.

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/21286cf90c639018aab4a1fd19a4d980_AydqjbEO5G.png?height=1026&lazyload=true&maxWidth=600&width=2882)

You can also check the [API List](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/server-api-list) and check whether the API is calculated in the call volume by using the **Included in billing** column field.

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/dbed816986ebd284d4e764ffb8564b41_iQCBfy1vv6.png?height=396&lazyload=true&maxWidth=600&width=1746)

## Effective Date

**From November 13, 2024**

- In Feishu Basic, the total API call limit for all enterprise custom apps under a single tenant is adjusted to **10,000 times/month**, but excessive OpenAPI calls are allowed.

- All Feishu versions begin to support viewing **API calls** through [Admin](https://www.feishu.cn/admin) > **Billing** > **My Quota** page.

**From December 3, 2024**

Feishu Basic enterprise custom apps will no longer be able to call the OpenAPI for calculating the call volume after exceeding the API call limit in the month. Continuing calls will fail and return the `99991403` error code.

## Get call volume data

### View API call volume

Enterprise administrators can log in to [Admin](https://www.feishu.cn/admin) and view the **API calls** on the **Billing** > **My Quota** page.
**Note**: All Feishu versions can view the used API call volume. Among them, the total number of API calls for Feishu Basic is displayed as **1 million calls** (limited-time offer only for June 2026).

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/c970122e08da5005c48c23e326040640_Bfj4mpq0Ys.png?height=1394&lazyload=true&maxWidth=600&width=2882)

### Excessive warning notification

When the total number of API calls of all custom apps in the enterprise reaches 90% or 100% of the upper limit, the open platform will push warning notifications to enterprise administrators and developers of custom apps. Among them:

- When the enterprise administrator logs in to the [Admin](https://www.feishu.cn/admin), the API call volume information can be viewed in the **Quota alert** area on the homepage.

- The open platform will send a card message notification through the Feishu client:

- When the call volume reaches 90% of the upper limit, the card message notification example is as follows.

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/36a94316103e95eca4ee25070eb448df_10kupTcuK0.png?height=1166&lazyload=true&maxWidth=600&width=2122)

- When the call volume reaches 100%, the card message notification example is as follows.

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/54287b6edbfe064b101072ad63a7654a_CzCxK4WfCG.png?height=1118&lazyload=true&maxWidth=600&width=2342)

## Increase the call limit

When the API call limit of an enterprise is reached, the custom apps in the enterprise will not be able to call the API (Note: APIs that are not counted in the call limit can still be called normally). Continuing to call the API will fail and return the following error message:

- HTTP status code: `429`
- Error code: `99991403`
- Error message: `This month's API call quota has been exceeded`

You can contact the enterprise administrator to upgrade the Feishu version. For Feishu version introduction and upgrade entry, see [Version Comparison](https://www.feishu.cn/service). If you have any questions, please [Contact Customer Service](https://applink.feishu.cn/client/web_url/open?width=400&height=600&mode=window&url=https%3A%2F%2Fwww.feishu.cn%2Focic%3Fsource%3D1%26channel_id%3D36).

## FAQ

### If an API call fails and returns a 4xx/5xx error code, does it count towards the company's API call volume?

No.

### When the open platform adjusts the rules for counting OpenAPI calls, does it take effect immediately?

No. The API call volume adjustment for the current month will take effect in the next month.

### Will the custom robot added to the group send messages via webhook to occupy the API call volume?

No. The [custom robot](https://open.feishu.cn/document/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN) added to the group pushes messages to the group via webhook and does not count towards the API call volume.