---
title: "Retrieve accepted-response counts."
method: GET
path: "/v1/usage"
---

# Retrieve accepted-response counts.

`GET /v1/usage`

## Request

- Base URL: `http://127.0.0.1:8080`
- URL: `http://127.0.0.1:8080/v1/usage`
- Auth: HTTP bearer

## Headers

- `X-Likerts-Workspace` string

## Response `200`

Success

- Usage: Response counts for observability. These values never gate acceptance or create a charge.
  - `acceptedResponses` integer, required: Lifetime accepted response count.
  - `monthAcceptedResponses` integer, required: Accepted response count in the current UTC month.

## Other responses

- `400`: Invalid input, resource identifier or workspace selection.
- `401`: Missing/invalid bearer credential, including wrong collection credential.
- `403`: The credential scope, membership or role does not permit this operation.
- `429`: Admission or collection rate limit reached. Honor Retry-After in seconds; admission usually returns1, the collection minute window returns60.
- `500`: Internal failure; do not assume a write failed. Retry only with its original idempotency key and payload.
- `503`: Distributed request admission is temporarily unavailable. No protected handler ran; honor Retry-After.

---

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