---
title: "Get per-connection usage"
method: GET
path: "/v1/platform/connections/{connectionId}/usage"
tags: ["Platform"]
---

# Get per-connection usage

`GET /v1/platform/connections/{connectionId}/usage`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/platform/connections/{connectionId}/usage`
- Auth: HTTP bearer

Returns inference spend for the current UTC month for this connection.

## Path parameters

- `connectionId` string, uuid, required

## Response `200`

Usage summary

- ConnectionUsageResponse
  - `connection_id` string, uuid, required
  - `period` string, required: UTC month (YYYY-MM)
  - `inference_spent_usd` string, required: Kept for compatibility — this field predates the breakdown below and existing integrations read it. Same number as `usage.inference_usd`.
  - `usage` UsageCounts, required
    - `api_requests` integer, required
    - `signatures` integer, required
    - `execution_intents` integer, required
    - `execution_intents_tee` integer, required
    - `inference_usd` string, required: A decimal string. Money is not a float; zero is "0".
    - `credits_debited_cents` integer, required
  - `period_start` string, date-time, required
  - `period_end` string, date-time, required: Exclusive. The period is half-open.

## Other responses

- `404`: Resource not found

---

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