Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. AI SRE investigations
    3. Post mortems
    4. Metadata & Catalog
    5. Screening alerts
    6. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
      1. Monitors API
        1. List monitors GET
        2. Get monitor GET
        3. Monitor response times GET
        4. Monitor availability GET
        5. Create monitor POST
        6. Update monitor PATCH
        7. Remove monitor DELETE
      2. Monitor groups API
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Monitor response times

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

GET https://incidents.betterstack.com/api/v2/monitors/{monitor_id}/response-times

URL parameters

monitor_id
required string

The ID of the monitor you want to get

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the monitor's response times from the last 24 hours, grouped by region.

Response 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.00002,
              "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.00002,
              "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.00002,
              "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.00002,
              "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.00002,
              "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.00002,
              "connection_time": 0.10989,
              "tls_handshake_time": 0.1224,
              "data_transfer_time": 0.11021
            }
          ]
        }
      ]
    }
  }
}

Response attributes

id
string

The ID of the monitor.

type
string

Always monitor_response_times.

attributes.regions
array

The response times of the last 24 hours, one entry per region. Server and Port monitors return a single eu entry with all their response times.

attributes.regions[].region
string

The region the checks ran from: us, eu, as, or au.

attributes.regions[].response_times
array

The checks from this region, oldest first.

attributes.regions[].response_times[].at
string

When the check ran, in ISO 8601 format.

attributes.regions[].response_times[].response_time
number

The total response time, in seconds.

attributes.regions[].response_times[].name_lookup_time
number

The time the DNS lookup took, in seconds.

attributes.regions[].response_times[].connection_time
number

The time connecting took, in seconds.

attributes.regions[].response_times[].tls_handshake_time
number

The time the TLS handshake took, in seconds.

attributes.regions[].response_times[].data_transfer_time
number

The time the data transfer took, in seconds.

Example cURL

Example
curl --request GET \
  --url https://incidents.betterstack.com/api/v2/monitors/123456789/response-times \
  --header "Authorization: Bearer $TOKEN"


Previous article

Get monitor

Next article

Monitor availability