# Monitor response times

Returns the response times for a monitor (last 24h).

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v2/monitors/{monitor_id}/response-times"
method = "GET"

[[path_param]]
name = "monitor_id"
description = "The ID of the monitor you want to get"
required = true
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
type = "string"
required = true
[/endpoint]

[responses]
[[response]]
status = 200
description = '''The response times are grouped by the server's region.'''
body = '''{
  "data": {
    "id": "270985",
    "type": "monitor_response_times",
    "attributes": {
      "regions": [
        {
          "region": "us",
          "response_times": [
            {
              "at": "2025-04-03T11:00:57.000Z",
              "response_time": 0.47273,
              "name_lookup_time": 0.000020,
              "connection_time": 0.14187,
              "tls_handshake_time": 0.19929,
              "data_transfer_time": 0.13154
            },
            {
              "at": "2025-04-03T11:01:27.000Z",
              "response_time": 0.41211,
              "name_lookup_time": 0.000020,
              "connection_time": 0.13058,
              "tls_handshake_time": 0.17109,
              "data_transfer_time": 0.11042
            },
            {
              "at": "2025-04-03T11:04:27.000Z",
              "response_time": 0.41943,
              "name_lookup_time": 0.000020,
              "connection_time": 0.10908,
              "tls_handshake_time": 0.19844,
              "data_transfer_time": 0.11188
            }
          ]
        },
        {
          "region": "eu",
          "response_times": [
            {
              "at": "2025-04-03T11:13:27.000Z",
              "response_time": 0.60383,
              "name_lookup_time": 0.000020,
              "connection_time": 0.15449,
              "tls_handshake_time": 0.31218,
              "data_transfer_time": 0.13714
            },
            {
              "at": "2025-04-03T11:13:57.000Z",
              "response_time": 0.36093,
              "name_lookup_time": 0.000020,
              "connection_time": 0.12147,
              "tls_handshake_time": 0.12925,
              "data_transfer_time": 0.11019
            },
            {
              "at": "2025-04-03T11:17:27.000Z",
              "response_time": 0.34252,
              "name_lookup_time": 0.000020,
              "connection_time": 0.10989,
              "tls_handshake_time": 0.1224,
              "data_transfer_time": 0.11021
            }
          ]
        }
      ]
    }
  }
}'''

[/responses]

#### Example cURL 

```shell
[label Example]
curl --request GET \
  --url https://uptime.betterstack.com/api/v2/monitors/123456789/response-times \
  --header "Authorization: Bearer $TOKEN"
```

[info]
#### Don't have your API token yet?
Please see [obtaining an API token](https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/)

#### Looking for the details of a specific parameter?
Explore [the list of all monitor API parameters](https://betterstack.com/docs/uptime/api/monitors-api-response-params/)
[/info]