---
title: "Get Num Message Left"
method: GET
path: "/api/chat/num-message-left"
tags: ["Chat"]
---

# Get Num Message Left

`GET /api/chat/num-message-left`

Get the number of messages left for a bot.

## Query parameters

- `bot_id` string, uuid, required

## Response `200`

Successful Response

- NumMessageLeftResponse — Schema for response containing the number of messages left.
  - `bot_id` string, uuid, required — Unique identifier for the associated bot.
  - `num_message_left` integer, required — Number of messages left.

## Other responses

- `422` — Validation Error

## Changes

> 3 revisions in range; 1 not diffed.

- **2023-11-13** `ac1f1ab68fcb` — 3 info
  - the endpoint scheme security `OAuth2PasswordBearerCookie` was added to the API
  - the endpoint scheme security `BasicAuth` was removed from the API
  - added the non-success response with the status `422`
- **2023-11-08** `dbd91277da05` — 4 info
  - the endpoint scheme security `BasicAuth` was added to the API
  - the endpoint scheme security `APIKeyAuth` was removed from the API
  - the endpoint scheme security `OAuth2PasswordBearerCookie` was removed from the API
  - removed the non-success response with the status `422`

[Change history](https://skmtc.dev/chat-fly/apis/chatfly-backend-application/changes/api/chat/num-message-left/get.md)

---

[API](https://skmtc.dev/chat-fly/apis/chatfly-backend-application.md) · [All operations](https://skmtc.dev/chat-fly/apis/chatfly-backend-application/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chat-fly/chatfly-backend-application/revisions/cbb37496f138/schema)