Metrics

Metrics record one row per request. They belong to your account. Reading needs usage:read. The list endpoint returns a compact summary of each request. The detail endpoint returns the full row. They do not return the same fields.

List metrics

GET /api/v1/metrics

integer

default:"1"

The page to return.

integer

default:"50"

Rows per page, from 1 to 100.

string

Filter to a single key. Must be a UUID.

string

Only include rows on or after this ISO 8601 datetime.

string

Only include rows on or before this ISO 8601 datetime.

curl 'https://app.nemu.cc/api/v1/metrics?page=1&limit=20' \
  -H 'Authorization: Bearer <access_token>'

const { data, pagination } = await nemu.metrics.list({ page: 1, limit: 20 });

{
  "data": [
    {
      "id": "met_1",
      "method": "POST",
      "endpoint": "/v1/chat/completions",
      "status_code": 200
    },
    {
      "id": "met_2",
      "method": "POST",
      "endpoint": "/v1/chat/completions",
      "status_code": 429,
      "blocked_reason": "Rate limit exceeded"
    }
  ],
  "pagination": {
    "page": 1,
    "pages": 1,
    "limit": 20,
    "total": 2
  }
}

string | object

Present only when the request was blocked or the status code was not 200. It is parsed JSON when the stored reason is JSON, and a plain string otherwise.

integer

The total number of pages. Pagination lives in its own object, not at the top level.

Get a metric

GET /api/v1/metrics/{id}

{
  "data": {
    "id": "met_1",
    "user_id": "3f0e...",
    "key_id": "key_1",
    "method": "POST",
    "endpoint": "/v1/chat/completions",
    "path": "/v1/chat/completions",
    "status_code": 200,
    "response_time": 812,
    "blocked": false,
    "blocked_reason": null,
    "ip_address": "203.0.113.4",
    "user_agent": "nemu-sdk/1.0",
    "created_at": "2026-01-04T10:22:00.000Z"
  }
}

integer

How long the request took, in milliseconds.

Delete a metric

Metrics cannot be deleted. DELETE /api/v1/metrics/{id} always returns 403.

Get started

Setup

API reference

List metrics

Get a metric

Delete a metric

​List metrics

​Get a metric

​Delete a metric

List metrics

Get a metric

Delete a metric