---
title: "Retrieve a check result"
method: GET
path: "/v1/check-results/{checkId}/{checkResultId}"
tags: ["Check results"]
---

# Retrieve a check result

`GET /v1/check-results/{checkId}/{checkResultId}`

Show details of a specific check result.

## Path parameters

- `checkId` string, uuid, required
- `checkResultId` string, uuid, required

## Headers

- `x-checkly-account` string, uuid — Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Response `200`

Successful

- CheckResult
  - `id` string — The unique ID of this result.
  - `name` string — The name of the check.
  - `checkId` string — The ID of the check.
  - `hasFailures` boolean — Describes if any failure occurred during this check run.
  - `hasErrors` boolean — Describes if an internal error occurred in Checkly's backend.
  - `isDegraded` boolean, nullable — Whether the check is over its degradation limit.
  - `isCancelled` boolean — Whether the run was cancelled before completion.
  - `overMaxResponseTime` boolean, nullable — Whether the response time exceeded its limit.
  - `runLocation` string — What data center location this check result originated from.
  - `startedAt` string, date-time, nullable
  - `stoppedAt` string, date-time, nullable
  - `created_at` string, date-time
  - `responseTime` number — Time the check spent producing its result, in milliseconds. For protocol checks this is the measured operation time; for browser, multi-step, Playwright and agentic checks it is the run wall-clock duration.
  - `apiCheckResult` CheckResultAPI, nullable — The response data for an API check.
    - `assertions` CheckResultFreeformObject[], nullable — List of API check assertions.
    - `request` object — The request for the API.
      - `method` string
      - `url` string
      - `data` string
      - `headers` CheckResultFreeformObject
      - `params` CheckResultFreeformObject
    - `response` object — The API response.
      - `status` number
      - `statusText` string
      - `body` string
      - `bodyEncoding` 'base64' — Encoding of `body`. Set to `base64` when the body holds base64-encoded raw bytes (raster image responses); absent for plain text bodies.
      - `headers` object, nullable
      - `timings` object, nullable
      - `timingPhases` object, nullable
    - `requestError` string, nullable — Describes if an error occurred on the request.
    - `jobLog` object, nullable — Check run log results.
    - `jobAssets` unknown[], nullable — Assets generated from the check run.
      - unknown
    - `pcapDataUrl` string, nullable — Packet capture data if available as redirect/download URL.
  - `browserCheckResult` CheckResultBrowser, nullable — The response data for a browser check.
    - `type` string — The type of framework the check is using.
    - `traceSummary` object — The summary of errors in the check run.
    - `pages` CheckResultFreeformObject[] — List of pages used on the check run.
    - `playwrightTestVideos` string[] — List of Playwright Test videos.
    - `errors` unknown[] — List of errors on the check run.
      - unknown
    - `endTime` number — End time of the check run.
    - `startTime` number — Start time of the check run.
    - `runtimeVersion` string — Active runtime version.
    - `jobLog` unknown[], nullable — Check run log results.
      - unknown
    - `jobAssets` unknown[], nullable — Assets generated from the check run.
      - unknown
    - `playwrightTestTraces` string[] — List of Playwright Test traces.
    - `playwrightTestJsonReportFile` string — Playwright Test JSON report.
  - `multiStepCheckResult` MultiStepResultBrowser, nullable — The response data for a multi-step check.
    - `errors` unknown[] — List of errors on the check run.
      - unknown
    - `endTime` number — End time of the check run.
    - `startTime` number — Start time of the check run.
    - `runtimeVersion` string — Active runtime version.
    - `jobLog` unknown[], nullable — Check run log results.
      - unknown
    - `jobAssets` unknown[], nullable — Assets generated from the check run.
      - unknown
    - `playwrightTestTraces` string[] — List of Playwright Test traces.
    - `playwrightTestJsonReportFile` string — Playwright Test JSON report.
  - `agenticCheckResult` CheckResultAgentic, nullable — The response data for an agentic check.
    - `summary` string, nullable — Human-readable recap of the agent run.
    - `prompt` string, nullable — The prompt that was executed for this run.
    - `assertions` AgenticAssertion[], nullable — List of assertions evaluated by the agent.
      - `condition` string — Human-readable condition the agent evaluated.
      - `passed` boolean — Whether the assertion passed.
      - `actual` string — What the agent actually observed.
      - `expected` string — What the assertion required.
    - `suggestions` AgenticSuggestion[], nullable — Suggestions produced by the agent.
      - `summary` string — Human-readable summary of the agent's suggestion.
      - `prompt` string — Prompt fragment the user can append to extend the check.
      - `promptReplacement` string — Full replacement prompt the user can apply when the suggestion is a correction.
      - `secrets` string[] — Environment variable names the suggestion would require.
      - `category` 'credentials' | 'endpoint' | 'configuration' — Category of the suggestion.
    - `steps` AgenticStep[], nullable — Sequence of tool calls and messages.
      - `type` 'tool_call' | 'tool_result' | 'message' — Kind of step emitted by the agent.
      - `name` string — Name of the tool invoked.
      - `input` object — Input passed to the tool, when applicable.
      - `output` string — Output text or message body.
      - `timestamp` string — ISO timestamp when the step was emitted.
      - `sequenceNumber` integer — Monotonic sequence number within a run.
    - `errors` CheckResultFreeformObject[], nullable — Errors recorded during the run.
    - `artifactManifest` object, nullable — Map of artifact file paths to descriptions.
  - `playwrightCheckResult` CheckResultPlaywright, nullable — The response data for a Playwright check.
    - `errors` CheckResultFreeformObject[], nullable — Per-test Playwright errors recorded during the run.
    - `playwrightTraceFiles` CheckResultPlaywrightTraceFile[], nullable — Trace file metadata recorded by the runner.
      - `url` string
      - `name` string
      - `filename` string
    - `jobLog` unknown[], nullable — Check run log results.
      - unknown
    - `jobAssets` unknown[], nullable — Assets generated from the check run.
      - unknown
    - `playwrightTestVideos` string[], nullable — Signed URLs for Playwright test videos.
    - `playwrightTestTraces` string[], nullable — Signed URLs for Playwright test traces.
    - `playwrightTestJsonReportFile` string, nullable — Signed URL for the Playwright JSON report.
  - `tracerouteCheckResult` CheckResultTraceroute, nullable — Failure-debug diagnostics for a traceroute check.
    - `totalHops` number — Number of hops recorded on the route.
    - `destinationReached` boolean — Whether the traceroute reached the destination host.
    - `finalHopLatency` object, nullable — Latency statistics for the final reached hop.
    - `timingPhases` object, nullable — Timing phases for the run.
    - `requestError` string, nullable — Describes if an error occurred on the request.
    - `request` object, nullable — The traceroute request that was executed.
    - `assertions` CheckResultFreeformObject[], nullable — Assertions evaluated for the run.
    - `response` object, nullable — The detailed traceroute response artifact.
      - `hostname` string
      - `resolvedIp` string
      - `totalHops` number
      - `destinationReached` boolean
      - `truncationReason` string — Why the route was truncated, if it was.
      - `finalHopLatency` object, nullable
      - `hops` CheckResultFreeformObject[], nullable
      - `protocol` string
      - `probeProtocol` string
  - `grpcCheckResult` CheckResultGrpc, nullable — Failure-debug diagnostics for a gRPC check.
    - `grpcStatusCode` number — The gRPC status code of the call.
    - `healthStatus` number, nullable — The numeric serving status returned by the gRPC health probe.
    - `timingPhases` object, nullable — Timing phases for the run.
    - `requestError` string, nullable — Describes if an error occurred on the request.
    - `request` object, nullable — The gRPC request that was executed.
    - `assertions` CheckResultFreeformObject[], nullable — Assertions evaluated for the run.
    - `response` object, nullable — The detailed gRPC response artifact.
      - `grpcMode` string
      - `host` string
      - `resolvedIp` string
      - `port` number
      - `grpcMethod` string
      - `responseMessage` string
      - `grpcStatusCode` number
      - `grpcStatusMessage` string
      - `healthStatus` number, nullable
      - `healthStatusLabel` string
      - `metadata` CheckResultFreeformObject[], nullable
      - `discoveredMethods` string[], nullable
      - `requestError` string, nullable
      - `timingPhases` object, nullable
  - `sslCheckResult` CheckResultSsl, nullable — Failure-debug diagnostics for an SSL check.
    - `tlsVersion` string — Negotiated TLS protocol version.
    - `cipherSuite` string — Negotiated cipher suite.
    - `daysUntilExpiry` number — Days until the leaf certificate expires.
    - `handshakeTimeMs` number — TLS handshake duration in milliseconds.
    - `chainTrusted` boolean — Whether the certificate chain was trusted.
    - `hostnameVerified` boolean — Whether the hostname matched the certificate.
    - `baselineVerdict` string — Overall security-baseline verdict.
    - `baselineGrade` string — Overall security-baseline grade.
    - `failureCategory` string, nullable — Categorised reason the check failed.
    - `requestError` string, nullable — Describes if an error occurred on the request.
    - `request` object, nullable — The SSL request that was executed.
    - `assertions` CheckResultFreeformObject[], nullable — Assertions evaluated for the run.
    - `response` object, nullable — The detailed SSL/TLS response artifact.
      - `resolvedIp` string
      - `protocol` string — Negotiated TLS version.
      - `cipherSuite` string
      - `handshakeTimeMs` number
      - `hostnameVerified` boolean
      - `chainTrusted` boolean
      - `daysUntilExpiry` number
      - `ocspStapled` boolean
      - `ocspStatus` string — Decoded stapled OCSP status.
      - `chainTrustReason` string — Typed reason the chain is untrusted.
      - `chainTrustDetail` string — Human-readable explanation of why the chain is untrusted.
      - `incompleteChain` boolean — Whether the server omitted an intermediate certificate.
      - `missingIntermediate` string — Issuer of the missing intermediate certificate.
      - `securityBaseline` object, nullable
      - `certificate` object, nullable
      - `chain` CheckResultFreeformObject[], nullable
  - `checkRunId` number — The id of the specific check run that created this result.
  - `attempts` number — How often this check was retried.
  - `resultType` 'FINAL' | 'ATTEMPT' | 'ALL', required — The type of result.
  - `sequenceId` string, uuid, nullable — The sequence ID of the check run.
  - `traceId` string, nullable, required — OpenTelemetry trace ID associated with this check result.
  - `errorGroupIds` string[], nullable — IDs of error groups associated with this check result.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `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/87d29dc7b4fe/schema)
