unbanChatMember

Unban a previously banned user from the chat.

Request

POST /:token/unbanchatmember

Parameters

Parameter	Type	Required	Description
chat_id	Integer/String	Yes	Unique identifier or username of the target chat
user_id	Integer	Yes	Unique identifier of the user to be unbanned
only_if_banned	Boolean	No	If set to true, the unban operation is only performed if the user is currently banned. This prevents accidentally removing a non-banned user from the chat

Response

Returns Boolean true on success.

{
  "ok": true,
  "result": true
}

Error Codes

Code	Description
400	Bad request parameters, such as missing chat_id or user_id
401	Invalid or expired token
403	Bot does not have administrator privileges or permission to unban users
404	Chat or user not found
500	Internal server error

Example

cURL

Unban a user

curl -X POST "https://api.example.com/<token>/unbanchatmember" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": -1001234567890,
    "user_id": 987654321
  }'

Unban only if currently banned

curl -X POST "https://api.example.com/<token>/unbanchatmember" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": -1001234567890,
    "user_id": 987654321,
    "only_if_banned": true
  }'