---
title: "Get comprehensive statistics for a provider"
method: GET
path: "/provider-stats/{miner_hotkey}"
tags: ["General APIs with JWT"]
---

# Get comprehensive statistics for a provider

`GET /provider-stats/{miner_hotkey}`

Endpoint to retrieve detailed statistics for a provider including network speed, location, feedback rates, rental failures, rental successes, uptime, and more.

## Path parameters

- `miner_hotkey` string, required

## Response `200`

Provider statistics retrieved successfully

- ProviderStatisticsResponse — Comprehensive provider statistics response.
  - `miner_hotkey` string, required — The hotkey of the provider
  - `average_network_speed` AverageNetworkSpeedResponse, required — Average network speed statistics.
    - `average_upload_speed_mbps` number, required — Average upload speed in Mbps
    - `average_download_speed_mbps` number, required — Average download speed in Mbps
    - `total_machines_with_network_data` integer, required — Number of machines with network data
  - `locations` LocationResponse[], required — List of unique machine locations
    - `country` string, nullable
    - `country_code` string, nullable
    - `region` string, nullable
    - `city` string, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `timezone` string, nullable
  - `feedback_rates` FeedbackRatesResponse, required — Feedback statistics.
    - `good_feedbacks` integer, required — Number of feedbacks with rating >= 4
    - `bad_feedbacks` integer, required — Number of feedbacks with rating < 4
    - `total_feedbacks` integer, required — Total number of feedbacks
    - `good_percentage` number, required — Percentage of good feedbacks
  - `rental_failures` RentalFailuresResponse, required — Rental failure statistics.
    - `rental_failures` integer, required — Number of pods that failed to start
  - `rental_successes` RentalSuccessResponse, required — Rental success statistics.
    - `rental_successes` integer, required — Number of successful rentals
  - `uptime_counts` UptimeCountsResponse, required — Uptime and reset statistics.
    - `average_uptime_hours` number, required — Average uptime across all machines in hours
    - `reclaimed_count` integer, required — Number of machines that have been reclaimed/reset
    - `total_machines` integer, required — Total number of machines
  - `max_rental_time` MaxRentalTimeResponse, required — Maximum rental duration statistics.
    - `max_rental_duration_hours` number, required — Maximum rental duration in hours
  - `unique_renters` UniqueRentersResponse, required — Unique renters statistics.
    - `unique_renters` integer, required — Number of unique users who rented from this provider
  - `unique_positive_renters` UniquePositiveRentersResponse, required — Unique positive renters statistics.
    - `unique_positive_renters` integer, required — Number of unique users who gave positive feedback
  - `collateral_status` CollateralStatusResponse, required — Collateral and verification status.
    - `total_machines` integer, required — Total number of machines
    - `collateral_deposited_count` integer, required — Number of machines with collateral deposited
    - `verified_count` integer, required — Number of verified machines
    - `active_count` integer, required — Number of active machines
    - `collateral_percentage` number, required — Percentage of machines with collateral
    - `verified_percentage` number, required — Percentage of verified machines

## Other responses

- `404` — Provider not found
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lium/lium-backend-api/revisions/084c90a2d8cb/schema)