Ga naar inhoud
buildinglinksbuildinglinks

Requests of the last hour, per minute

GET
/api/v1/stats/live
curl --request GET \
  --url https://example.com/api/v1/stats/live \
  --cookie bl_%3Cslug%3E_session=%3Cbl_%3Cslug%3E_session%3E

The data plane’s requests per minute over the last hour, the current minute included (it fills as the data plane writes its counts every 10 s). Light enough to poll every few seconds.

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

OK.

Media typeapplication/json

/api/v1/stats/live: documents the JSON built in [live_stats].

object
minutes
required

The last 60 minutes; the last one is still filling.

Array<object>

Requests in one period (an hour or a minute).

object
at
required
string format: date-time
requests
required
integer format: int64
errors
required
integer format: int64
requests_last_minute
required

The last complete minute.

integer format: int64
requests_per_second
required
number format: double
requests_hour
required
integer format: int64
errors_hour
required
integer format: int64

Example generated

{
  "minutes": [
    {
      "at": "2026-04-15T12:00:00Z",
      "requests": 1,
      "errors": 1
    }
  ],
  "requests_last_minute": 1,
  "requests_per_second": 1,
  "requests_hour": 1,
  "errors_hour": 1
}

401

Section titled “401”

No valid session, DPoP-bound token or API key.

Media typeapplication/json

The body of every failed call to a management API.

object
error
required
object
code
required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string
message
required

For people; may change between versions.

string

Example 

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}

403

Section titled “403”

The caller lacks the role this operation needs; or a change with the session cookie came from a page of another site (cross_site_request, decisions #83).

Media typeapplication/json

The body of every failed call to a management API.

object
error
required
object
code
required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string
message
required

For people; may change between versions.

string

Example 

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}