---
title: "Monitor credit usage"
method: GET
path: "/monitors/credit-usage"
tags: ["Monitors"]
---

# Monitor credit usage

`GET /monitors/credit-usage`

Returns credits charged per monitor over an optional [since, until] window, newest spenders first.

## Query parameters

- `since` string, date-time — Only include items at or after this ISO 8601 timestamp.
- `until` string, date-time — Only include items before this ISO 8601 timestamp.

## Response `200`

Per-monitor credit usage

- MonitorsCreditUsageResponse
  - `data` MonitorsCreditUsage[], required
    - `monitor_id` string, required
    - `name` string, required — Monitor name (falls back to the id when the monitor was deleted).
    - `credits` integer, required — Credits charged to this monitor over the window.
    - `runs` integer, required — Number of billed runs over the window.
  - `total_credits` integer, required — Sum of credits across all monitors in the window.

## Other responses

- `401` — Unauthorized

## Changes

- **2026-08-08** `182f532c2552` — 1 warning
  - added the new `WEBSITE_BLOCKED` enum value to the `error_code` response property for the response status `401`
- **2026-08-07** `3c6a01ba967f` — 1 warning
  - added the new `COLD_DOMAIN_TIMEOUT_TOO_LOW` enum value to the `error_code` response property for the response status `401`
- **2026-08-06** `fc8ac2f5f021` — 4 warning
  - added the new `CONTENT_TOO_LARGE` enum value to the `error_code` response property for the response status `401`
  - added the new `PDF_IMAGES_ONLY` enum value to the `error_code` response property for the response status `401`
  - added the new `PDF_SKIPPED` enum value to the `error_code` response property for the response status `401`
  - added the new `WEBSITE_NOT_FOUND` enum value to the `error_code` response property for the response status `401`
- **2026-07-31** `f5c503b03f98` — 4 warning
  - added the new `BATCH_LIMIT_EXCEEDED` enum value to the `error_code` response property for the response status `401`
  - added the new `BATCH_NOT_CANCELLABLE` enum value to the `error_code` response property for the response status `401`
  - added the new `BATCH_NOT_COMPLETED` enum value to the `error_code` response property for the response status `401`
  - added the new `IDEMPOTENCY_KEY_CONFLICT` enum value to the `error_code` response property for the response status `401`
- …earlier changes not shown

[Full history](https://skmtc.dev/context/apis/context-dev/changes/monitors/credit-usage/get.md)

---

[API](https://skmtc.dev/context/apis/context-dev.md) · [All operations](https://skmtc.dev/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/context/context-dev/revisions/1febe5476266/schema)