---
title: "Fetch usage"
method: GET
path: "/usage/fetch"
tags: ["Usage"]
---

# Fetch usage

`GET /usage/fetch`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/usage/fetch`
- Auth: HTTP bearer

Fetches the usage data for the user in the current billing period.

## Response `200`

The usage information was retrieved successfully

- object
  - `tokens` number, required: The number of tokens the user has used
  - `conversations` number, required: The number of conversations the user has created
  - `messages` number, required: The number of messages the user has sent
  - `database` object, required: Database usage information
    - `datasets` number, required: The number of datasets the user has created
    - `records` number, required: The number of records the user has created
    - `skillsets` number, required: The number of skillsets the user has created
    - `abilities` number, required: The number of abilities the user has created
    - `files` number, required: The number of files the user has created
    - `users` number, required: The number of users the user has created

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)