providers

Get historical statistics for a specific provider.

Returns time series data for the specified provider within the given time range. Data is returned as hourly or daily buckets depending on the granularity parameter.

Note: Historical stats require Prometheus to be configured via observability.metrics.prometheus_query_url. In single-node deployments without Prometheus, this endpoint returns an error.

get/admin/v1/providers/{provider_name}/stats/history

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /admin/v1/providers/{provider_name}/stats/history
  • Auth: HTTP bearer

Path parameters

provider_namestring required

Provider name

Query parameters

startstring date-time nullable

Start of the time range (defaults to 24 hours ago).

endstring date-time nullable

End of the time range (defaults to now).

granularitystring nullable

Granularity of the data points: "hour" or "day" (defaults to "hour").

Response

Historical stats for the provider

granularity'hour' | 'day' required

Granularity for historical stats queries.

prometheus_configuredboolean

Whether Prometheus is configured for historical metrics. When false, the data array will be empty because historical stats require Prometheus to be configured.

providerstring required

Provider name

Changes

No recorded changes to this operation across all 1 revision of this API.