---
title: "Get new chat limit"
method: GET
path: "/business/limits/new_chat"
tags: ["Business"]
---

# Get new chat limit

`GET /business/limits/new_chat`

Returns the current account limit for starting new individual chats.

## Response `200`

OK

- NewChatLimit
  - `limit` number, required — Number of new individual chats allowed in the current cycle. -1 means WhatsApp did not report a limit.
  - `used` number, required — Number of new individual chats already used in the current cycle. -1 means WhatsApp did not report usage.
  - `remaining` number, required — Number of new individual chats remaining in the current cycle. -1 means unavailable.
  - `cycle_start_at` number, nullable, required — Unix timestamp in seconds when the current cycle starts. Null means WhatsApp did not report a usable timestamp.
  - `cycle_end_at` number, nullable, required — Unix timestamp in seconds when the current cycle ends. Null means WhatsApp did not report a usable timestamp.
  - `updated_at` number, nullable, required — Unix timestamp in seconds when WhatsApp reported this state. Null means WhatsApp did not report a usable timestamp.
  - `status` 'none' | 'first_warning' | 'second_warning' | 'capped', required — WhatsApp status for the new chat limit.
  - `ote_status` 'not_eligible' | 'eligible' | 'active_in_current_cycle' | 'exhausted', required — WhatsApp one-time extension status for the new chat limit.
  - `mv_status` 'not_eligible' | 'not_active' | 'active' | 'active_upgrade_available', required — WhatsApp multi-verification status for the new chat limit.

## Other responses

- `401` — Need channel authorization
- `500` — Internal Error

---

[API](https://skmtc.net/whapi/apis/whatsapp-api.md) · [All operations](https://skmtc.net/whapi/apis/whatsapp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whapi/whatsapp-api/versions/40ab05abffdb/schema)