---
search:
  tags:
    - Account
    - GET
seo:
  description: >-
    Returns a per-meter count of operations recorded for this account since the
    server started.… Reference for the GET /v1/usage endpoint in the Webfold
    API.
sidebar:
  label: Usage report
  badge: GET
title: Usage report
type: openapi-operation
---
Returns a per-meter count of operations recorded for this account since
the server started. Local counters when billing is disabled; also
mirrors events posted to FlexPrice when billing is enabled.

`GET /v1/usage`

**Responses**

- `200` — Usage counters
- `401` — Missing or invalid bearer token
- `403` — Billing or plan entitlement blocked the request

Response example, 200:

```json
{
  "events": {
    "arxiv.search": 5,
    "web.scrape": 2
  }
}
```
