---
title: "Get usage line items"
method: GET
path: "/api/v1/usage/line-items"
tags: ["Usage"]
---

# Get usage line items

`GET /api/v1/usage/line-items`

## Request

- Base URL: `https://botsee.io`
- URL: `https://botsee.io/api/v1/usage/line-items`
- Auth: HTTP bearer

Lists individual paid operations (line items), newest first. One row per site, category, operation, and resource.

## Query parameters

- `from` string
- `to` string
- `site_uuid` string
- `category` string
- `limit` integer

## Response `200`

Successful response.

- object
  - `from` string
  - `line_items` object[]
    - `category` string
    - `credits` integer
    - `domain` string
    - `last_charged_at` string
    - `name` string
    - `operation` string
    - `site_uuid` string
  - `to` string

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but lacks permission (e.g. botsee_disabled).
- `404`: The requested resource does not exist or is not accessible.
- `422`: Request body or parameters failed validation.
- `429`: Too many requests. Wait and retry per Retry-After header.

---

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