Data

Uptime check history

GET /api/v1/projects/{id}/uptime/checks

Newest first. Pass meta.nextBefore as before to get the next page.

API key access: Read only or read and write
Project permission: View health
Success: 200 — OK

Parameters

Path

Parameter	Type	Notes
`id` required	string	Project id

Query string

Parameter	Type	Notes
`limit`	integer	default 50 · min 1 · max 100
`before`	string (date-time)	Only checks created before this time

Example request

Replace tk_live_YOUR_KEY with your API key and the ids with your own.

curl 'https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301/uptime/checks?limit=2' \
  -H 'Authorization: Bearer tk_live_YOUR_KEY'

const response = await fetch('https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301/uptime/checks?limit=2', {
  headers: {
    Authorization: 'Bearer tk_live_YOUR_KEY',
  },
});

const result = await response.json();
if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
console.log(result.data);

import requests

response = requests.get(
    "https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301/uptime/checks",
    headers={"Authorization": "Bearer tk_live_YOUR_KEY"},
    params={
        "limit": 2,
    },
)
result = response.json()
if not response.ok:
    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")
print(result["data"])

Example response

200 OK

{
  "data": [
    {
      "id": "6653d7f5b4e6a8c0d2f4b601",
      "kind": "health",
      "status": "success",
      "statusCode": 200,
      "errorClass": null,
      "errorMessage": null,
      "requestedUrl": "https://acmeretail.com/",
      "finalUrl": "https://acmeretail.com/",
      "redirectChain": [],
      "crossHostRedirect": false,
      "downgradedToHttp": false,
      "timing": {
        "dnsMs": 12,
        "connectMs": 31,
        "tlsMs": 44,
        "ttfbMs": 182,
        "totalMs": 241,
        "startedAt": null
      },
      "healthCheckFailures": [],
      "tls": {
        "subjectCn": "acmeretail.com",
        "issuer": "Let's Encrypt",
        "validFrom": "2026-09-10T00:00:00.000Z",
        "validTo": "2026-12-09T23:59:59.000Z",
        "daysRemaining": 64
      },
      "createdAt": "2026-10-06T09:25:12.000Z"
    },
    {
      "id": "6653d7f5b4e6a8c0d2f4b602",
      "kind": "health",
      "status": "failed",
      "statusCode": 503,
      "errorClass": "http_5xx",
      "errorMessage": "Server returned 503",
      "requestedUrl": "https://acmeretail.com/",
      "finalUrl": null,
      "redirectChain": [],
      "crossHostRedirect": false,
      "downgradedToHttp": false,
      "timing": {
        "dnsMs": 11,
        "connectMs": 29,
        "tlsMs": 41,
        "ttfbMs": 1904,
        "totalMs": 1910,
        "startedAt": null
      },
      "healthCheckFailures": [],
      "tls": null,
      "createdAt": "2026-10-06T09:20:12.000Z"
    }
  ],
  "meta": {
    "limit": 2,
    "nextBefore": "2026-10-06T09:20:12.000Z"
  }
}

Response fields

Field	Type	Notes
`data`	array of UptimeCheck
`data[].id`	string
`data[].kind`	string
`data[].status`	string
`data[].statusCode`	integer or null
`data[].errorClass`	string or null
`data[].errorMessage`	string or null
`data[].requestedUrl`	string or null
`data[].finalUrl`	string or null
`data[].redirectChain`	array of object
`data[].crossHostRedirect`	boolean
`data[].downgradedToHttp`	boolean
`data[].timing`	object	Milliseconds, e.g. ttfbMs, totalMs
`data[].healthCheckFailures`	array of object
`data[].tls`	object or null
`data[].createdAt`	string (date-time)

Errors

Besides the errors any request can return (bad or missing key, plan, scope, rate limit), this endpoint can return:

Status	error.code	Meaning
400	`invalid-request`	A parameter or body field is missing or invalid; `error.message` says which.
404	`not-found`	The resource does not exist or you cannot open it. Tracker does not reveal which.
403	`flag-viewHealth`	Your project membership does not include viewing health.

Errors always look like { "error": { "code": "…", "message": "…" } }. See Errors & limits.