---
title: "Retrieve an uptime check"
method: GET
path: "/uptime/{test_id}"
tags: ["uptime"]
---

# Retrieve an uptime check

`GET /uptime/{test_id}`

Returns an uptime check with the given id.

## Path parameters

- `test_id` string, required

## Response `200`

OK

- UptimeTestResponse
  - `data` UptimeTest, required
    - `id` string, required — Uptime check ID
    - `name` string, required — Name of the check
    - `test_type` 'DNS' | 'HEAD' | 'HTTP' | 'PING' | 'SMTP' | 'SSH' | 'TCP', required — Uptime check type
    - `website_url` string, uri, required — URL, FQDN, or IP address of the server under test
    - `check_rate` 0 | 30 | 60 | 300 | 900 | 1800 | 3600 | 86400, required — Number of seconds between checks
    - `confirmation` integer, required — Number of confirmation servers to confirm downtime before an alert is triggered
    - `contact_groups` string[], required — List of contact group IDs
    - `custom_header` string — JSON object. Represents headers to be sent when making requests
    - `dns_ips` string[], required — List of IP addresses to compare against returned DNS records
    - `dns_server` string — FQDN or IP address of the nameserver to query
    - `do_not_find` boolean, required — Whether to consider the check as down if the content is present within the response
    - `enable_ssl_alert` boolean, required — Whether to send an alert if the SSL certificate is soon to expire
    - `final_endpoint` string — Specify where the redirect chain should end
    - `find_string` string — String to look for within the response. Considered down if not found
    - `follow_redirects` boolean, required — Whether to follow redirects when testing. Disabled by default
    - `include_header` boolean, required — Include header content in string match search
    - `host` string — Name of the hosting provider
    - `last_tested_at` string, date-time — When the check was last run (RFC3339 format)
    - `next_location` string — The server location the check will run next
    - `paused` boolean, required — Whether the check should be run
    - `port` integer — Destination port for TCP checks
    - `post_body` string — JSON object. Payload submitted with the request. Setting this updates the check to use the HTTP POST verb
    - `post_raw` string — Raw HTTP POST string to send to the server
    - `processing` boolean, required — Whether the check is currently being processed
    - `processing_on` string — The server location the check is currently being run
    - `processing_state` 'complete' | 'pretest' | 'retest' | 'up_retest' — Uptime check proccessing state
    - `servers` MonitoringLocation[], required — List of assigned monitoring locations on which to run checks
      - `description` string, required — Server description
      - `ipv4` string, ipv4 — Server IPv4 address
      - `ipv6` string, ipv6 — Server IPv6 address
      - `region` string, required — Server region
      - `region_code` string, required — Server region code
      - `status` 'down' | 'up', required — Server status
    - `status` 'down' | 'up', required — The returned status of an uptime check
    - `status_codes` string[], required — List of status codes that trigger an alert
    - `tags` string[], required — List of tags
    - `timeout` integer, required — The number of seconds to wait to receive the first byte
    - `trigger_rate` integer, required — The number of minutes to wait before sending an alert
    - `uptime` number, float, required — Uptime percentage for a check
    - `use_jar` boolean, required — Whether to enable cookie storage
    - `user_agent` string — Custom user agent string set when testing

## Other responses

- `default` — Unexpected Error

---

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