> ## Documentation Index
> Fetch the complete documentation index at: https://checkly-422f444a-mintlify-f27640bd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a check result

> Show details of a specific check result.



## OpenAPI

````yaml get /v1/check-results/{checkId}/{checkResultId}
openapi: 3.0.0
info:
  title: Checkly Public API
  version: v1
  description: >-
    These are the docs for the newly released Checkly Public API. If you have
    any questions, please do not hesitate to get in touch with us.
servers:
  - url: https://api.checklyhq.com
security:
  - Bearer: []
tags: []
paths:
  /v1/check-results/{checkId}/{checkResultId}:
    get:
      tags:
        - Check results
      summary: Retrieve a check result
      description: Show details of a specific check result.
      operationId: getV1CheckresultsCheckidCheckresultid
      parameters:
        - schema:
            type: string
            minLength: 1
            format: uuid
          required: true
          name: checkId
          in: path
        - schema:
            type: string
            minLength: 1
            format: uuid
          required: true
          name: checkResultId
          in: path
        - schema:
            type: string
            format: uuid
            description: >-
              Your Checkly account ID, you can find it at
              https://app.checklyhq.com/settings/account/general
          required: false
          description: >-
            Your Checkly account ID, you can find it at
            https://app.checklyhq.com/settings/account/general
          name: x-checkly-account
          in: header
      responses:
        '200':
          description: Successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckResult'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    CheckResult:
      type: object
      properties:
        id:
          type: string
          description: The unique ID of this result.
        name:
          type: string
          description: The name of the check.
        checkId:
          type: string
          description: The ID of the check.
        hasFailures:
          type: boolean
          description: Describes if any failure occurred during this check run.
        hasErrors:
          type: boolean
          description: Describes if an internal error occurred in Checkly's backend.
        isDegraded:
          type: boolean
          nullable: true
          description: Whether the check is over its degradation limit.
        isCancelled:
          type: boolean
          description: Whether the run was cancelled before completion.
        overMaxResponseTime:
          type: boolean
          nullable: true
          description: Whether the response time exceeded its limit.
        runLocation:
          type: string
          description: What data center location this check result originated from.
        startedAt:
          type: string
          nullable: true
          format: date-time
        stoppedAt:
          type: string
          nullable: true
          format: date-time
        created_at:
          type: string
          format: date-time
        responseTime:
          type: number
          description: >-
            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:
          $ref: '#/components/schemas/CheckResultAPI'
        browserCheckResult:
          $ref: '#/components/schemas/CheckResultBrowser'
        multiStepCheckResult:
          $ref: '#/components/schemas/MultiStepResultBrowser'
        agenticCheckResult:
          $ref: '#/components/schemas/CheckResultAgentic'
        playwrightCheckResult:
          $ref: '#/components/schemas/CheckResultPlaywright'
        tracerouteCheckResult:
          $ref: '#/components/schemas/CheckResultTraceroute'
        grpcCheckResult:
          $ref: '#/components/schemas/CheckResultGrpc'
        sslCheckResult:
          $ref: '#/components/schemas/CheckResultSsl'
        checkRunId:
          type: number
          description: The id of the specific check run that created this result.
        attempts:
          type: number
          description: How often this check was retried.
        resultType:
          type: string
          enum:
            - FINAL
            - ATTEMPT
            - ALL
          description: The type of result.
        sequenceId:
          type: string
          nullable: true
          format: uuid
          description: The sequence ID of the check run.
        traceId:
          type: string
          nullable: true
          description: OpenTelemetry trace ID associated with this check result.
        errorGroupIds:
          type: array
          nullable: true
          items:
            type: string
            format: uuid
          default: []
          description: IDs of error groups associated with this check result.
      required:
        - resultType
        - traceId
    ApiError:
      type: object
      properties:
        statusCode:
          type: number
        error:
          type: string
        message:
          type: string
      required:
        - statusCode
        - error
        - message
    CheckResultAPI:
      type: object
      nullable: true
      properties:
        assertions:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/CheckResultFreeformObject'
          default: []
          description: List of API check assertions.
        request:
          type: object
          properties:
            method:
              type: string
            url:
              type: string
            data:
              type: string
            headers:
              $ref: '#/components/schemas/CheckResultFreeformObject'
            params:
              $ref: '#/components/schemas/CheckResultFreeformObject'
          description: The request for the API.
        response:
          type: object
          properties:
            status:
              type: number
            statusText:
              type: string
            body:
              type: string
            bodyEncoding:
              type: string
              enum:
                - base64
              description: >-
                Encoding of `body`. Set to `base64` when the body holds
                base64-encoded raw bytes (raster image responses); absent for
                plain text bodies.
            headers:
              allOf:
                - $ref: '#/components/schemas/CheckResultFreeformObject'
                - nullable: true
            timings:
              allOf:
                - $ref: '#/components/schemas/CheckResultFreeformObject'
                - nullable: true
            timingPhases:
              allOf:
                - $ref: '#/components/schemas/CheckResultFreeformObject'
                - nullable: true
          description: The API response.
        requestError:
          type: string
          nullable: true
          description: Describes if an error occurred on the request.
        jobLog:
          type: object
          nullable: true
          properties: {}
          additionalProperties:
            nullable: true
          description: Check run log results.
        jobAssets:
          type: array
          nullable: true
          items:
            nullable: true
          description: Assets generated from the check run.
        pcapDataUrl:
          type: string
          nullable: true
          description: Packet capture data if available as redirect/download URL.
      description: The response data for an API check.
    CheckResultBrowser:
      type: object
      nullable: true
      properties:
        type:
          type: string
          description: The type of framework the check is using.
        traceSummary:
          type: object
          properties: {}
          additionalProperties:
            nullable: true
          description: The summary of errors in the check run.
        pages:
          type: array
          items:
            $ref: '#/components/schemas/CheckResultFreeformObject'
          description: List of pages used on the check run.
        playwrightTestVideos:
          type: array
          items:
            type: string
          description: List of Playwright Test videos.
        errors:
          type: array
          items:
            nullable: true
          description: List of errors on the check run.
        endTime:
          type: number
          description: End time of the check run.
        startTime:
          type: number
          description: Start time of the check run.
        runtimeVersion:
          type: string
          description: Active runtime version.
        jobLog:
          type: array
          nullable: true
          items:
            nullable: true
          description: Check run log results.
        jobAssets:
          type: array
          nullable: true
          items:
            nullable: true
          description: Assets generated from the check run.
        playwrightTestTraces:
          type: array
          items:
            type: string
          description: List of Playwright Test traces.
        playwrightTestJsonReportFile:
          type: string
          description: Playwright Test JSON report.
      description: The response data for a browser check.
    MultiStepResultBrowser:
      type: object
      nullable: true
      properties:
        errors:
          type: array
          items:
            nullable: true
          description: List of errors on the check run.
        endTime:
          type: number
          description: End time of the check run.
        startTime:
          type: number
          description: Start time of the check run.
        runtimeVersion:
          type: string
          description: Active runtime version.
        jobLog:
          type: array
          nullable: true
          items:
            nullable: true
          description: Check run log results.
        jobAssets:
          type: array
          nullable: true
          items:
            nullable: true
          description: Assets generated from the check run.
        playwrightTestTraces:
          type: array
          items:
            type: string
          description: List of Playwright Test traces.
        playwrightTestJsonReportFile:
          type: string
          description: Playwright Test JSON report.
      description: The response data for a multi-step check.
    CheckResultAgentic:
      type: object
      nullable: true
      properties:
        summary:
          type: string
          nullable: true
          description: Human-readable recap of the agent run.
        prompt:
          type: string
          nullable: true
          description: The prompt that was executed for this run.
        assertions:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/AgenticAssertion'
          default: []
          description: List of assertions evaluated by the agent.
        suggestions:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/AgenticSuggestion'
          default: []
          description: Suggestions produced by the agent.
        steps:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/AgenticStep'
          default: []
          description: Sequence of tool calls and messages.
        errors:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/CheckResultFreeformObject'
          default: []
          description: Errors recorded during the run.
        artifactManifest:
          type: object
          nullable: true
          properties: {}
          additionalProperties:
            nullable: true
          description: Map of artifact file paths to descriptions.
      description: The response data for an agentic check.
    CheckResultPlaywright:
      type: object
      nullable: true
      properties:
        errors:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/CheckResultFreeformObject'
          default: []
          description: Per-test Playwright errors recorded during the run.
        playwrightTraceFiles:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/CheckResultPlaywrightTraceFile'
          default: []
          description: Trace file metadata recorded by the runner.
        jobLog:
          type: array
          nullable: true
          items:
            nullable: true
          description: Check run log results.
        jobAssets:
          type: array
          nullable: true
          items:
            nullable: true
          description: Assets generated from the check run.
        playwrightTestVideos:
          type: array
          nullable: true
          items:
            type: string
          description: Signed URLs for Playwright test videos.
        playwrightTestTraces:
          type: array
          nullable: true
          items:
            type: string
          description: Signed URLs for Playwright test traces.
        playwrightTestJsonReportFile:
          type: string
          nullable: true
          description: Signed URL for the Playwright JSON report.
      description: The response data for a Playwright check.
    CheckResultTraceroute:
      type: object
      nullable: true
      properties:
        totalHops:
          type: number
          description: Number of hops recorded on the route.
        destinationReached:
          type: boolean
          description: Whether the traceroute reached the destination host.
        finalHopLatency:
          type: object
          nullable: true
          properties: {}
          additionalProperties:
            nullable: true
          description: Latency statistics for the final reached hop.
        timingPhases:
          type: object
          nullable: true
          properties: {}
          additionalProperties:
            nullable: true
          description: Timing phases for the run.
        requestError:
          type: string
          nullable: true
          description: Describes if an error occurred on the request.
        request:
          type: object
          nullable: true
          properties: {}
          additionalProperties:
            nullable: true
          description: The traceroute request that was executed.
        assertions:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/CheckResultFreeformObject'
          description: Assertions evaluated for the run.
        response:
          type: object
          nullable: true
          properties:
            hostname:
              type: string
            resolvedIp:
              type: string
            totalHops:
              type: number
            destinationReached:
              type: boolean
            truncationReason:
              type: string
              description: Why the route was truncated, if it was.
            finalHopLatency:
              allOf:
                - $ref: '#/components/schemas/CheckResultFreeformObject'
                - nullable: true
            hops:
              type: array
              nullable: true
              items:
                $ref: '#/components/schemas/CheckResultFreeformObject'
            protocol:
              type: string
            probeProtocol:
              type: string
          description: The detailed traceroute response artifact.
      description: Failure-debug diagnostics for a traceroute check.
    CheckResultGrpc:
      type: object
      nullable: true
      properties:
        grpcStatusCode:
          type: number
          description: The gRPC status code of the call.
        healthStatus:
          type: number
          nullable: true
          description: The numeric serving status returned by the gRPC health probe.
        timingPhases:
          type: object
          nullable: true
          properties: {}
          additionalProperties:
            nullable: true
          description: Timing phases for the run.
        requestError:
          type: string
          nullable: true
          description: Describes if an error occurred on the request.
        request:
          type: object
          nullable: true
          properties: {}
          additionalProperties:
            nullable: true
          description: The gRPC request that was executed.
        assertions:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/CheckResultFreeformObject'
          description: Assertions evaluated for the run.
        response:
          type: object
          nullable: true
          properties:
            grpcMode:
              type: string
            host:
              type: string
            resolvedIp:
              type: string
            port:
              type: number
            grpcMethod:
              type: string
            responseMessage:
              type: string
            grpcStatusCode:
              type: number
            grpcStatusMessage:
              type: string
            healthStatus:
              type: number
              nullable: true
            healthStatusLabel:
              type: string
            metadata:
              type: array
              nullable: true
              items:
                $ref: '#/components/schemas/CheckResultFreeformObject'
            discoveredMethods:
              type: array
              nullable: true
              items:
                type: string
            requestError:
              type: string
              nullable: true
            timingPhases:
              allOf:
                - $ref: '#/components/schemas/CheckResultFreeformObject'
                - nullable: true
          description: The detailed gRPC response artifact.
      description: Failure-debug diagnostics for a gRPC check.
    CheckResultSsl:
      type: object
      nullable: true
      properties:
        tlsVersion:
          type: string
          description: Negotiated TLS protocol version.
        cipherSuite:
          type: string
          description: Negotiated cipher suite.
        daysUntilExpiry:
          type: number
          description: Days until the leaf certificate expires.
        handshakeTimeMs:
          type: number
          description: TLS handshake duration in milliseconds.
        chainTrusted:
          type: boolean
          description: Whether the certificate chain was trusted.
        hostnameVerified:
          type: boolean
          description: Whether the hostname matched the certificate.
        baselineVerdict:
          type: string
          description: Overall security-baseline verdict.
        baselineGrade:
          type: string
          description: Overall security-baseline grade.
        failureCategory:
          type: string
          nullable: true
          description: Categorised reason the check failed.
        requestError:
          type: string
          nullable: true
          description: Describes if an error occurred on the request.
        request:
          type: object
          nullable: true
          properties: {}
          additionalProperties:
            nullable: true
          description: The SSL request that was executed.
        assertions:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/CheckResultFreeformObject'
          description: Assertions evaluated for the run.
        response:
          type: object
          nullable: true
          properties:
            resolvedIp:
              type: string
            protocol:
              type: string
              description: Negotiated TLS version.
            cipherSuite:
              type: string
            handshakeTimeMs:
              type: number
            hostnameVerified:
              type: boolean
            chainTrusted:
              type: boolean
            daysUntilExpiry:
              type: number
            ocspStapled:
              type: boolean
            ocspStatus:
              type: string
              description: Decoded stapled OCSP status.
            chainTrustReason:
              type: string
              description: Typed reason the chain is untrusted.
            chainTrustDetail:
              type: string
              description: Human-readable explanation of why the chain is untrusted.
            incompleteChain:
              type: boolean
              description: Whether the server omitted an intermediate certificate.
            missingIntermediate:
              type: string
              description: Issuer of the missing intermediate certificate.
            securityBaseline:
              allOf:
                - $ref: '#/components/schemas/CheckResultFreeformObject'
                - nullable: true
            certificate:
              allOf:
                - $ref: '#/components/schemas/CheckResultFreeformObject'
                - nullable: true
            chain:
              type: array
              nullable: true
              items:
                $ref: '#/components/schemas/CheckResultFreeformObject'
          description: The detailed SSL/TLS response artifact.
      description: Failure-debug diagnostics for an SSL check.
    CheckResultFreeformObject:
      type: object
      properties: {}
      additionalProperties:
        nullable: true
    AgenticAssertion:
      type: object
      properties:
        condition:
          type: string
          description: Human-readable condition the agent evaluated.
        passed:
          type: boolean
          description: Whether the assertion passed.
        actual:
          type: string
          description: What the agent actually observed.
        expected:
          type: string
          description: What the assertion required.
    AgenticSuggestion:
      type: object
      properties:
        summary:
          type: string
          description: Human-readable summary of the agent's suggestion.
        prompt:
          type: string
          description: Prompt fragment the user can append to extend the check.
        promptReplacement:
          type: string
          description: >-
            Full replacement prompt the user can apply when the suggestion is a
            correction.
        secrets:
          type: array
          items:
            type: string
          description: Environment variable names the suggestion would require.
        category:
          type: string
          enum:
            - credentials
            - endpoint
            - configuration
          description: Category of the suggestion.
    AgenticStep:
      type: object
      properties:
        type:
          type: string
          enum:
            - tool_call
            - tool_result
            - message
          description: Kind of step emitted by the agent.
        name:
          type: string
          description: Name of the tool invoked.
        input:
          type: object
          properties: {}
          additionalProperties:
            nullable: true
          description: Input passed to the tool, when applicable.
        output:
          type: string
          description: Output text or message body.
        timestamp:
          type: string
          description: ISO timestamp when the step was emitted.
        sequenceNumber:
          type: integer
          description: Monotonic sequence number within a run.
    CheckResultPlaywrightTraceFile:
      type: object
      properties:
        url:
          type: string
        name:
          type: string
        filename:
          type: string
      additionalProperties:
        nullable: true
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: Bearer
      description: >-
        The Checkly Public API uses API keys to authenticate requests. You can
        get the API Key
        [here](https://app.checklyhq.com/settings/user/api-keys). Your API key
        is like a password: keep it secure!

        Authentication to the API is performed using the Bearer auth method in
        the Authorization header and using the account ID.

        For example, set **Authorization** header while using cURL: `curl -H
        "Authorization: Bearer [apiKey]" "X-Checkly-Account: [accountId]"` 

````