Checkly

Checkly Check Alerts API

The Check Alerts API from Checkly — 2 operation(s) for check alerts.

GitHub OpenAPI
Business capability
Incident Response Management BC-4220.30

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/check-alerts List alerts across all checks · List all alerts for your account #
Ask an LLM
“Which alerts fired across my whole account in the last six hours?”
“How wide a time window can I query for account alerts?”
Tell an agent
List all check alerts in my account.
Show every alert for my account between {from} and {to}.
GET /v1/check-alerts/{checkId} List alerts for one check · List alerts for a specific check #
Ask an LLM
“What alerts has a specific check triggered recently?”
“Can I see one check's alert history for a chosen window?”
Tell an agent
List alerts for check {checkId}.
Show alerts for check {checkId} from {from} to {to}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/checkly/refs/heads/main/openapi/checkly-check-alerts-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/checkly:checkly-check-alerts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

checkly-check-alerts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Checkly Public Check alerts 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:
- name: Check alerts
paths:
  /v1/check-alerts:
    get:
      summary: List all alerts for your account
      operationId: getV1Checkalerts
      description: 'Lists all alerts that have been sent for your account.


        Use the `to` and `from` parameters to specify a date range (UNIX timestamp in seconds). This endpoint will return data within a 6-hour timeframe. If the `from` and `to` params are set, they must be at most 6 hours apart. If none are set, we will consider the `to` param to be now and the `from` param to be 6 hours earlier. If only the `to` param is set we will set `from` to be 6 hours earlier. If only the `from` param is set we will consider the `to` param to be 6 hours later.'
      tags:
      - Check alerts
      responses:
        '200':
          description: Successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckAlertList'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsError'
      parameters:
      - schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 10
          description: Limit the number of results
        required: false
        description: Limit the number of results
        name: limit
        in: query
      - schema:
          type: number
          default: 1
          description: Page number
          exclusiveMinimum: 0
        required: false
        description: Page number
        name: page
        in: query
      - schema:
          type: string
          format: date
          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: string
          format: date
          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: string
          x-format:
            guid: true
          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
  /v1/check-alerts/{checkId}:
    get:
      summary: List alerts for a specific check
      operationId: getV1CheckalertsCheckid
      description: 'Lists all the alerts for a specific check.


        Use the `to` and `from` parameters to specify a date range (UNIX timestamp in seconds). This endpoint will return data within a 6-hour timeframe. If the `from` and `to` params are set, they must be at most 6 hours apart. If none are set, we will consider the `to` param to be now and the `from` param to be 6 hours earlier. If only the `to` param is set we will set `from` to be 6 hours earlier. If only the `from` param is set we will consider the `to` param to be 6 hours later.'
      tags:
      - Check alerts
      responses:
        '200':
          description: Successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckAlertList'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsError'
      parameters:
      - schema:
          type: string
          x-format:
            guid: true
        required: true
        name: checkId
        in: path
      - schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 10
          description: Limit the number of results
        required: false
        description: Limit the number of results
        name: limit
        in: query
      - schema:
          type: number
          default: 1
          description: Page number
          exclusiveMinimum: 0
        required: false
        description: Page number
        name: page
        in: query
      - schema:
          type: string
          format: date
          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: string
          format: date
          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: string
          x-format:
            guid: true
          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
components:
  schemas:
    ForbiddenError:
      type: object
      properties:
        statusCode:
          type: number
          enum:
          - 403
        error:
          $ref: '#/components/schemas/Model1'
        message:
          type: string
          example: Forbidden
      required:
      - statusCode
      - error
    NotFoundError:
      type: object
      properties:
        statusCode:
          type: number
          enum:
          - 404
        error:
          $ref: '#/components/schemas/Model4'
        message:
          type: string
          example: Not Found
      required:
      - statusCode
      - error
    UnauthorizedError:
      type: object
      properties:
        statusCode:
          type: number
          enum:
          - 401
        error:
          $ref: '#/components/schemas/error'
        message:
          type: string
          example: Bad Token
        attributes:
          $ref: '#/components/schemas/attributes'
      required:
      - statusCode
      - error
    attributes:
      type: object
    TooManyRequestsError:
      type: object
      properties:
        statusCode:
          type: number
          enum:
          - 429
        error:
          $ref: '#/components/schemas/Model2'
        message:
          type: string
          example: Too Many Requests
        attributes:
          $ref: '#/components/schemas/attributes'
      required:
      - statusCode
      - error
    CheckAlert:
      type: object
      properties:
        id:
          type: string
          description: The unique ID of this alert.
          example: '1'
        name:
          type: string
          description: The name of the check.
          example: API Check
        checkId:
          type: string
          description: The ID of the check this alert belongs to.
          example: db147a95-6ed6-44c9-a584-c5dca2db3aaa
        alertType:
          type: string
          enum:
          - NO_ALERT
          - ALERT_FAILURE
          - ALERT_FAILURE_REMAIN
          - ALERT_FAILURE_DEGRADED
          - ALERT_RECOVERY
          - ALERT_DEGRADED
          - ALERT_DEGRADED_REMAIN
          - ALERT_DEGRADED_FAILURE
          - ALERT_DEGRADED_RECOVERY
          - ALERT_SSL
          description: The type of alert.
          example: ALERT_FAILURE
        checkType:
          type: string
          enum:
          - AGENTIC
          - API
          - BROWSER
          - HEARTBEAT
          - ICMP
          - MULTI_STEP
          - TCP
          - PLAYWRIGHT
          - TRACEROUTE
          - URL
          - DNS
          - SSL
          - GRPC
          description: The type of the check.
          example: API
        runLocation:
          type: string
          description: What data center location this check alert was triggered from.
          example: us-east-1
        responseTime:
          type: number
          description: Describes the time it took to execute relevant parts of this check. Any setup time or system time needed to start executing this check in the Checkly backend is not part of this.
          example: 10
        error:
          type:
          - string
          - 'null'
          description: Any specific error messages that were part of the failing check triggering the alert.
          example: OK
        statusCode:
          type:
          - string
          - 'null'
          description: The status code of the response. Only applies to API checks.
          example: '200'
        created_at:
          type: string
          format: date-time
          description: The date and time this check alert was created.
        startedAt:
          type: string
          format: date-time
          description: The date and time this check alert was started.
      required:
      - name
    Model4:
      type: string
      enum:
      - Not Found
    error:
      type: string
      enum:
      - Unauthorized
    CheckAlertList:
      type: array
      items:
        $ref: '#/components/schemas/CheckAlert'
    Model2:
      type: string
      enum:
      - Too Many Requests
    ApiError:
      type: object
      properties:
        statusCode:
          type: number
        error:
          type: string
        message:
          type: string
      required:
      - statusCode
      - error
      - message
    Model1:
      type: string
      enum:
      - Forbidden
  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 <a href="https://app.checklyhq.com/settings/user/api-keys" target="_blank">here</a>.</br>Your API key is like a password: <br>keep it secure!</br></br>Authentication to the API is performed using the Bearer auth method in the Authorization header and using the account ID.</br></br>For example, set <b>Authorization</b> header while using cURL: <code>curl -H "Authorization: Bearer [apiKey]" "X-Checkly-Account: [accountId]"</code></br>'