> ## 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. # Lists all check results > **[DEPRECATED] This endpoint will be removed soon. Please use the `GET /v2/check-results/{checkId}` endpoint instead.** Lists the full, raw check results for a specific check. We keep raw results for 30 days. After 30 days they are erased. However, we keep the rolled up results for an indefinite period. You can filter by check type and result type to narrow down the list. Use the `to` and `from` parameters to specify a date range (UNIX timestamp in seconds). Depending on the check type, some fields might be null. This endpoint will return data within a 6-hour timeframe. If the `from` and `to` params are set, they must be at most six hours apart. If none are set, we will consider the `to` param to be now and the `from` param to be six hours earlier. If only the `to` param is set we will set `from` to be six hours earlier. On the contrary, if only the `from` param is set we will consider the `to` param to be six hours later. **Rate-limiting is applied to this endpoint, you can send 60 requests / 60 seconds at most.** ## OpenAPI ````yaml get /v1/check-results/{checkId} 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}: get: tags: - Check results summary: Lists all check results description: >- **[DEPRECATED] This endpoint will be removed soon. Please use the `GET /v2/check-results/{checkId}` endpoint instead.** Lists the full, raw check results for a specific check. We keep raw results for 30 days. After 30 days they are erased. However, we keep the rolled up results for an indefinite period. You can filter by check type and result type to narrow down the list. Use the `to` and `from` parameters to specify a date range (UNIX timestamp in seconds). Depending on the check type, some fields might be null. This endpoint will return data within a 6-hour timeframe. If the `from` and `to` params are set, they must be at most six hours apart. If none are set, we will consider the `to` param to be now and the `from` param to be six hours earlier. If only the `to` param is set we will set `from` to be six hours earlier. On the contrary, if only the `from` param is set we will consider the `to` param to be six hours later. **Rate-limiting is applied to this endpoint, you can send 60 requests / 60 seconds at most.** operationId: getV1CheckresultsCheckid parameters: - schema: type: string minLength: 1 format: uuid required: true name: checkId in: path - schema: type: integer minimum: 1 maximum: 100 default: 10 description: Limit the number of results to fetch (default 10) required: false description: Limit the number of results to fetch (default 10) name: limit in: query - schema: type: string enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - ca-central-1 - sa-east-1 - eu-west-1 - eu-central-1 - eu-west-2 - eu-west-3 - eu-north-1 - eu-south-1 - me-south-1 - ap-southeast-1 - ap-northeast-1 - ap-east-1 - ap-southeast-2 - ap-southeast-3 - ap-northeast-2 - ap-northeast-3 - ap-south-1 - af-south-1 description: >- Provide a data center location, e.g. "eu-west-1" to filter by location required: false description: >- Provide a data center location, e.g. "eu-west-1" to filter by location name: location in: query - schema: type: string enum: - AGENTIC - API - BROWSER - HEARTBEAT - ICMP - MULTI_STEP - TCP - PLAYWRIGHT - TRACEROUTE - URL - DNS - SSL - GRPC description: The type of the check required: false description: The type of the check name: checkType in: query - schema: type: boolean description: Check result has one or more failures required: false description: Check result has one or more failures name: hasFailures in: query - schema: type: string enum: - FINAL - ATTEMPT - ALL default: FINAL description: The check result type (FINAL,ATTEMPT,ALL) required: false description: The check result type (FINAL,ATTEMPT,ALL) name: resultType in: query - schema: type: number description: >- Select records up from this UNIX timestamp (>= date). Defaults to now - 6 hours. required: false description: >- Select records up from this UNIX timestamp (>= date). Defaults to now - 6 hours. name: from in: query - schema: type: number description: >- Optional. Select records up to this UNIX timestamp (< date). Defaults to 6 hours after "from". required: false description: >- Optional. Select records up to this UNIX timestamp (< date). Defaults to 6 hours after "from". name: to in: query - schema: type: number minimum: 0 exclusiveMinimum: true default: 1 description: Page number required: false description: Page number name: page in: query - 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/CheckResultList' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ApiError' '402': description: Payment Required content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/ApiError' deprecated: true components: schemas: CheckResultList: type: array items: $ref: '#/components/schemas/CheckResult' ApiError: type: object properties: statusCode: type: number error: type: string message: type: string required: - statusCode - error - message 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 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]"` ````