Events

List pings for a check

Returns the most recent pings received for the check (newest first). Always returns a JSON array (never null). Privacy-sensitive fields (source_ip_hash, ua) are never included.

get/api/v1/checks/{id}/pings

Request

  • Base URL: https://app.lastping.dev
  • URL: https://app.lastping.dev/api/v1/checks/{id}/pings
  • Auth: API key in header X-Api-Key

Query parameters

limitinteger
Example:50

Maximum number of pings to return (default 50, max 200).

Response

Array of pings (may be empty).

idstring uuid

Unique ping identifier.

kindstring

Ping kind. One of success, start, fail, log, cancel, blocked, note. blocked marks the run as waiting on a human (pauses run-clock detection until cleared); note is a labelled informational signal that carries free text in the request body, visible here via body_excerpt. A success whose body failed an output assertion (one set on the monitor, or an expectation the run declared) is stored and returned as fail: it ended its run as a failure.

ridstring

Optional run identifier supplied by the sender (omitted when empty).

body_excerptstring

First 500 bytes of the ping request body (omitted when empty).

received_atstring date-time

RFC 3339 UTC timestamp when the ping was received.

duration_msinteger

Wall-clock duration in milliseconds of the run this ping completed. Present only when this ping is a success that paired with a preceding start on the same rid; omitted otherwise (never 0 or null as a stand-in for "absent").

fail_cause'assertion'

Why this ping reads fail although its sender did not send a fail. assertion: it arrived as a success and an output assertion (one set on the monitor, or an expectation the run declared) failed it. Omitted on every other ping, including a fail the job sent itself.

Example response

[
  {
    "id": "a0b1c2d3-0000-0000-0000-000000000001",
    "kind": "success",
    "rid": "job-42",
    "body_excerpt": "backup finished ok",
    "received_at": "2026-07-10T03:00:05Z",
    "duration_ms": 1523,
    "fail_cause": "assertion"
  }
]

Changes

No recorded changes to this operation across all 2 revisions of this API.