Domains

List a website's check history

Recorded outcomes, newest first. Liveness checks write a row on every status change plus a heartbeat every six hours; the expiry clocks write on every probe. History is kept for 90 days.

get/v1/domains/{id}/history

Request

  • Base URL: https://api.upcheck.so
  • URL: https://api.upcheck.so/v1/domains/{id}/history
  • Auth: HTTP bearer

Path parameters

idstring required
Example:9b1d...

Opaque identifier.

Query parameters

limitinteger

Rows to return.

offsetinteger

Rows to skip.

Response

The history page.

idstring required

Opaque identifier.

organizationIdstring required

Opaque identifier.

domainIdstring required

Opaque identifier.

monitorIdstring nullable required

Opaque identifier.

timestampnumber required

Unix ms.

subject'http' | 'certificate' | 'dns' | 'registration' | 'keyword' | 'content' | 'port' nullable required

Which check a monitor, rule or history row is about.

result'healthy' | 'renewed' | 'expiring_soon' | 'expired' | 'validation_failed' | 'unreachable' | 'at_risk' | 'unsupported' | 'lookup_failed' | 'up' | 'down' | 'changed' | 'passed' | 'failed' | 'unknown' required
messagestring required
daysRemainingnumber nullable required

Example response

[
  {
    "id": "9b1d...",
    "organizationId": "9b1d...",
    "domainId": "9b1d...",
    "monitorId": "9b1d..."
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.