---
title: "Retrieve a check session"
method: GET
path: "/v1/check-sessions/{checkSessionId}"
tags: ["Check sessions"]
deprecated: true
---

# Retrieve a check session

`GET /v1/check-sessions/{checkSessionId}`

> **Deprecated.**

Retrieves a check session. Results may be incomplete if the check session is still in progress.

Once a check session has finished, results will include at least one check result for each run location: one result with `resultType` equal to `"FINAL"`, and zero or more results with `resultType` equal to `"ATTEMPT"` (one for each failed attempt, if any).

Each result contains just enough information to quickly determine whether the check run was successful or not. To dive even deeper into individual results, use the `GET /v1/check-results/{checkId}/{checkResultId}` endpoint to retrieve detailed data about a specific result.

## Path parameters

- `checkSessionId` string, required — The unique identifier of the check session.

## Response `200`

The current state of the check session.

- FindOneCheckSessionResponse — The current state of the check session.
  - `checkSessionId` string, required — The unique identifier of the check session.
  - `checkSessionLink` string, required — A link to the check session.
  - `checkId` string, required — The ID of the check.
  - `checkType` 'AGENTIC' | 'API' | 'BROWSER' | 'ICMP' | 'MULTI_STEP' | 'TCP' | 'PLAYWRIGHT' | 'TRACEROUTE' | 'URL' | 'DNS' | 'SSL' | 'GRPC', required
  - `name` string
  - `status` 'STARTED' | 'PROGRESS' | 'FAILED' | 'PASSED' | 'DEGRADED' | 'PROGRESS_FAILED' | 'PROGRESS_DEGRADED' | 'TIMED_OUT' | 'CANCELLED', required — The status of the check session.
  - `startedAt` string, date-time, required — The date and time when the session started.
  - `stoppedAt` string, date-time, nullable — The date and time when the session stopped.
  - `timeElapsed` number, required — The time the check session took, in milliseconds.
  - `runLocations` string[], required — The run locations of the check session.
  - `runSource` 'CLI_DEPLOY' | 'DEPLOYMENT' | 'DEPLOYMENT_CACHE_WARMER' | 'EDITOR' | 'GROUP_RUN_ALL' | 'LEGACY_TRIGGER' | 'SCHEDULER' | 'SCHEDULE_NOW' | 'SLACK_RERUN' | 'TEST_NO_RECORD' | 'TEST_RECORD' | 'TRIGGER_NO_RECORD' | 'TRIGGER_RECORD' | 'TRIGGER_API', nullable — The source that triggered the check session.
  - `results` CheckSessionConciseCheckResult[] — The results of the check session. Only partial results are available until the check session has completed.
    - `checkResultId` string, required — The ID of the check result.
    - `checkResultLink` string, required — A link to the check result.
    - `checkId` string, required — The ID of the check.
    - `checkType` 'AGENTIC' | 'API' | 'BROWSER' | 'ICMP' | 'MULTI_STEP' | 'TCP' | 'PLAYWRIGHT' | 'TRACEROUTE' | 'URL' | 'DNS' | 'SSL' | 'GRPC', required
    - `name` string
    - `runLocation` string, required — The location where the check ran.
    - `resultType` 'FINAL' | 'ATTEMPT' | 'ALL', nullable, required — The type of the result.
    - `hasErrors` boolean, required — Whether the result has errors.
    - `hasFailures` boolean, required — Whether the result has failures.
    - `isDegraded` boolean, required — Whether the result is degraded.
    - `aborted` boolean, required — Whether the check was aborted.
    - `isCancelled` boolean, required — Whether the check was cancelled before completion.
    - `responseTime` number, nullable — Time the check spent producing its result, in milliseconds. For protocol checks this is the measured operation time (a subset of the run): request time for API and URL checks, connection time for TCP, resolution time for DNS, average latency for ICMP and TRACEROUTE, request timing for GRPC, and TLS handshake time for SSL. For browser, multi-step, Playwright and agentic checks it is the run wall-clock duration. Null until the check has finished. For the total wall-clock time a check run took, use stoppedAt - startedAt.
    - `startedAt` string, date-time, nullable — The date and time when the check run started.
    - `stoppedAt` string, date-time, nullable — The date and time when the check run finished. Subtract startedAt for the total wall-clock duration of the run.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — No such check session exists.
- `429` — Too Many Requests

---

[API](https://skmtc.net/checklyhq/apis/checkly-public-api.md) · [All operations](https://skmtc.net/checklyhq/apis/checkly-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/checklyhq/checkly-public-api/revisions/9e903da4f3da/schema)