{
  "id": "endpoints-stats",
  "title": "Endpoints stats requests",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/requests/endpoints-stats/",
  "summary": "Endpoint statistics requests",
  "content": "\n| Method | Path | Description |\n|--------|------|-------------|\n| [GET](#get-endpoints-stats) | `/v1/endpoints/stats` | Get stats for all endpoints |\n\n## Get all endpoints stats {#get-endpoints-stats}\n\n\tGET /v1/endpoints/stats\n\nGet statistics for all endpoint-proxy links.\n\n\nThis method will return both endpoints and listeners stats for backwards\ncompatability.\n\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_endpoint_stats]() |\n\n### Request {#get-request} \n\n#### Example HTTP request\n\n\tGET /v1/endpoints/stats?interval=1hour\u0026stime=2014-08-28T10:00:00Z \n\n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n\n#### Query parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| interval | string | Time interval for which we want stats: 1sec/10sec/5min/15min/1hour/12hour/1week (optional) |\n| stime | ISO_8601 | Start time from which we want the stats. Should comply with the [ISO_8601](https://en.wikipedia.org/wiki/ISO_8601) format (optional) |\n| etime | ISO_8601 | End time after which we don't want the stats. Should comply with the [ISO_8601](https://en.wikipedia.org/wiki/ISO_8601) format (optional) |\n\n### Response {#get-response} \n\nThe `uid` format in the response is: `\"BDB_UID:ENDPOINT_UID:PROXY_UID\"`\n\nFor example: `{\"uid\": \"1:2:3\"}` means `BDB_UID=1`, `ENDPOINT_UID=2`, and `PROXY_UID=3`\n\n#### Example JSON body\n\n```json\n[\n   {\n      \"uid\" : \"365:1:1\",\n      \"intervals\" : [\n         {\n            \"interval\" : \"10sec\",\n            \"total_req\" : 0,\n            \"egress_bytes\" : 0,\n            \"cmd_get\" : 0,\n            \"monitor_sessions_count\" : 0,\n            \"auth_errors\" : 0,\n            \"acc_latency\" : 0,\n            \"stime\" : \"2017-01-12T14:59:50Z\",\n            \"write_res\" : 0,\n            \"total_connections_received\" : 0,\n            \"cmd_set\" : 0,\n            \"read_req\" : 0,\n            \"max_connections_exceeded\" : 0,\n            \"acc_write_latency\" : 0,\n            \"write_req\" : 0,\n            \"other_res\" : 0,\n            \"cmd_flush\" : 0,\n            \"acc_read_latency\" : 0,\n            \"other_req\" : 0,\n            \"conns\" : 0,\n            \"write_started_res\" : 0,\n            \"cmd_touch\" : 0,\n            \"read_res\" : 0,\n            \"auth_cmds\" : 0,\n            \"etime\" : \"2017-01-12T15:00:00Z\",\n            \"total_started_res\" : 0,\n            \"ingress_bytes\" : 0,\n            \"last_res_time\" : 0,\n            \"read_started_res\" : 0,\n            \"acc_other_latency\" : 0,\n            \"total_res\" : 0,\n            \"last_req_time\" : 0,\n            \"other_started_res\" : 0\n         }\n      ]\n   },\n   {\n      \"intervals\" : [\n         {\n            \"acc_read_latency\" : 0,\n            \"other_req\" : 0,\n            \"etime\" : \"2017-01-12T15:00:00Z\",\n            \"auth_cmds\" : 0,\n            \"total_started_res\" : 0,\n            \"write_started_res\" : 0,\n            \"cmd_touch\" : 0,\n            \"conns\" : 0,\n            \"read_res\" : 0,\n            \"total_res\" : 0,\n            \"other_started_res\" : 0,\n            \"last_req_time\" : 0,\n            \"read_started_res\" : 0,\n            \"last_res_time\" : 0,\n            \"ingress_bytes\" : 0,\n            \"acc_other_latency\" : 0,\n            \"egress_bytes\" : 0,\n            \"interval\" : \"10sec\",\n            \"total_req\" : 0,\n            \"acc_latency\" : 0,\n            \"auth_errors\" : 0,\n            \"cmd_get\" : 0,\n            \"monitor_sessions_count\" : 0,\n            \"read_req\" : 0,\n            \"max_connections_exceeded\" : 0,\n            \"total_connections_received\" : 0,\n            \"cmd_set\" : 0,\n            \"acc_write_latency\" : 0,\n            \"write_req\" : 0,\n            \"stime\" : \"2017-01-12T14:59:50Z\",\n            \"write_res\" : 0,\n            \"cmd_flush\" : 0,\n            \"other_res\" : 0\n         }\n      ],\n      \"uid\" : \"333:1:2\"\n   }\n]\n```\n\n### Status codes {#get-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00",
  "children": []
}