---
title: "GET /connections/{phoneNumber}/new-chat-cap"
method: GET
path: "/connections/{phoneNumber}/new-chat-cap"
tags: ["Connections"]
---

# GET /connections/{phoneNumber}/new-chat-cap

`GET /connections/{phoneNumber}/new-chat-cap`

Fetch the account's new-chat message cap and usage — an antecedent indicator of the 463 restriction (how many new conversations can still be started this cycle). Read-only: queries WhatsApp directly (MEX) without sending a message.

## Path parameters

- `phoneNumber` string, required

## Response `200`

New-chat message cap retrieved successfully

- object
  - `data` object
    - `total_quota` number — Total new-chat messages allowed in the current cycle
    - `used_quota` number — New-chat messages already used in the current cycle
    - `cycle_start_timestamp` string, nullable — Unix timestamp of the cycle start
    - `cycle_end_timestamp` string, nullable — Unix timestamp of the cycle end
    - `server_sent_timestamp` string, nullable — Unix timestamp when WhatsApp produced this snapshot
    - `ote_status` string, nullable — One-time-engagement cap status (NOT_ELIGIBLE, ELIGIBLE, ACTIVE_IN_CURRENT_CYCLE, EXHAUSTED)
    - `mv_status` string, nullable — Multi-vertical cap status (NOT_ELIGIBLE, NOT_ACTIVE, ACTIVE, ACTIVE_UPGRADE_AVAILABLE)
    - `capping_status` string, nullable — Overall capping status (NONE, FIRST_WARNING, SECOND_WARNING, CAPPED)

## Other responses

- `403` — Forbidden — the API key does not own this connection. Returned when a connection is bound to a different API key.
- `404` — Phone number not connected
- `421` — Misdirected Request — in cluster mode, this instance does not own the connection. The owning instance id is in the x-baileys-owner header; a proxy re-routes the request there. Not returned for POST /connections/{phoneNumber} (explicit takeover).

---

[API](https://skmtc.net/fazer-ai/apis/fazer-ai-baileys-api.md) · [All operations](https://skmtc.net/fazer-ai/apis/fazer-ai-baileys-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fazer-ai/fazer-ai-baileys-api/revisions/533b3360e2e4/schema)