---
title: "Get current bot info"
method: GET
path: "/me"
tags: ["bots"]
---

# Get current bot info

`GET /me`

## Request

- Base URL: `https://botapi.tamtam.chat`
- URL: `https://botapi.tamtam.chat/me`
- Auth: API key in query parameter `access_token`

Returns info about current bot. Current bot can be identified by access token. Method returns bot identifier, name and avatar (if any)

## Response `200`

Bot info

- BotInfo
  - `user_id` integer, required: Users identifier
  - `name` string, required: Users visible name
  - `username` string, nullable, required: Unique public user name. Can be `null` if user is not accessible or it is not set
  - `is_bot` boolean, required: `true` if user is bot
  - `last_activity_time` integer, required: Time of last user activity in TamTam (Unix timestamp in milliseconds). Can be outdated if user disabled its "online" status in settings
  - `description` string, nullable: User description. Can be `null` if user did not fill it out
  - `avatar_url` string: URL of avatar
  - `full_avatar_url` string: URL of avatar of a bigger size
  - `commands` BotCommand[], nullable: Commands supported by bot
    - `name` string, required: Command name
    - `description` string, nullable: Optional command description

## Other responses

- `401`: Authorization Error. No `access_token` provided or token is invalid
- `500`: Internal Server Error

## Changes

- **2021-05-31** `dc45288cfedc`: 1 info
  - added the required property `allOf[#/components/schemas/UserWithPhoto]/allOf[#/components/schemas/User]/last_activity_time` to the response with the `200` status
- **2020-04-02** `93fb5d18fdf2`: 1 info
  - the response property `allOf[#/components/schemas/UserWithPhoto]/allOf[#/components/schemas/User]/is_bot` became required for the status `200`
- **2020-04-02** `f4ed817ac50f`: 1 info
  - added the optional property `allOf[#/components/schemas/UserWithPhoto]/allOf[#/components/schemas/User]/is_bot` to the response with the `200` status
- **2020-02-11** `6cd9dbaf139d`: 1 warning, 1 info
  - removed the optional property `allOf[subschema #2]/description` from the response with the `200` status
  - added the optional property `allOf[#/components/schemas/UserWithPhoto]/allOf[subschema #2]/description` to the response with the `200` status

[Operation history](https://skmtc.dev/tamtam/apis/tamtam-bot-api/changes/me/get.md)

---

[API](https://skmtc.dev/tamtam/apis/tamtam-bot-api.md) - [All operations](https://skmtc.dev/tamtam/apis/tamtam-bot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tamtam/apis/tamtam-bot-api/revisions/fa85402ea716?raw)