# Account API

> KickBot API and MCP reference for the account area: channel overview, plan limits, 30-day activity, Kick data refresh and the moderator check.

Source: https://kickbot.com/docs/api/reference/account

Use the account actions to learn about the channel before you change anything. `get_account_overview` is the first call for every script and agent.

Each action is a REST endpoint under `https://kickbot.com/api/v1` and an MCP tool with the same name. The MCP area name is `account`. Use it to load only this area: `https://kickbot.com/api/v1/mcp?areas=account`.

Every team member with API access can use this area. It needs no feature permission. Owners and admins have every permission. Write actions also need a read and write key or connection. See [Permissions and security](https://kickbot.com/docs/api/start/permissions-and-security).

How the feature works in the dashboard: [Add KickBot as a moderator](https://kickbot.com/docs/getting-started/add-kickbot-as-moderator), [Account settings](https://kickbot.com/docs/account/settings).

## Actions

| Tool | REST | Access |
|---|---|---|
| [`get_account_overview`](#get_account_overview) | `GET /account` | Read |
| [`get_channel_activity`](#get_channel_activity) | `GET /account/activity` | Read |
| [`refresh_kick_data`](#refresh_kick_data) | `POST /account/refresh-kick-data` | Write |
| [`check_moderator_status`](#check_moderator_status) | `POST /account/check-moderator` | Write |

## get_account_overview

**Get the account overview.** Start here. Returns the channel, its plan (free or premium) and plan limits, your team role and permissions, what this credential may do, and which areas of KickBot you can use. Call it before making changes.

```http
GET /api/v1/account
```

No input fields.

## get_channel_activity

**Get the channel activity of the last 30 days.** The dashboard Home page: KickBot interactions per day and per feature in the last 30 days (tts, clips, commands, timed_message, chat_alert, ai_character, ai_images, tips, moderated), the busiest day, highlights (top clip, top TTS voice, top command), which features are on, counts at a glance, when the TTS widget was last open in OBS, and the public links (tip page, clips page, voice list). Tip money (tips_amount_30d_cents, biggest_tip_cents, in US cents) is shown only with the tipping configuration permission; otherwise it is null.

```http
GET /api/v1/account/activity
```

| Field | Type | Required | Description |
|---|---|---|---|
| `time_zone` (query) | string | No | IANA time zone for the day boundaries, for example "Europe/Berlin". Default UTC. An unknown zone uses UTC. |

## refresh_kick_data

**Refresh the Kick channel data.** Load the channel name, profile picture, follower count, and stream link from Kick again (the same as "Refresh Kick data" in Settings). Use it after the streamer changed something on Kick. `partial: true` means Kick gave the name and picture but not the follower count and stream link this time.

```http
POST /api/v1/account/refresh-kick-data
```

Needs a read and write key or connection. This has an effect outside your settings (for example on your live stream). Rate limit: 20 per minute.

No input fields.

## check_moderator_status

**Check if KickBot is a moderator.** Check on Kick now whether KickBot is a moderator in the channel, and save the answer (the same as the "Check again" button in the dashboard warning). Many chat features need KickBot as a moderator: the streamer types /mod KickBot in their Kick chat, then you call this.

```http
POST /api/v1/account/check-moderator
```

Needs a read and write key or connection. This has an effect outside your settings (for example on your live stream). Rate limit: 20 per minute.

No input fields.