API reference

Score history

The score over time for a monitored site — one point per completed scan. Use it to render a trend chart and demonstrate that remediation is moving the number in the right direction.

GET/v1/sites/{id}/history

Response

An ordered array of points, oldest to newest.

Field	Type	Description
scan_id	string	The scan this point came from.
overall_score	number	0–100 at that time.
grade	string	A–F at that time.
completed_at	string	ISO 8601 timestamp.

json

[
  { "scan_id": "scan_01", "overall_score": 64, "grade": "D", "completed_at": "2026-05-01T09:00:00Z" },
  { "scan_id": "scan_07", "overall_score": 78, "grade": "C", "completed_at": "2026-05-15T09:00:00Z" },
  { "scan_id": "scan_14", "overall_score": 88, "grade": "B", "completed_at": "2026-06-01T09:00:00Z" }
]

Examples

curl -s https://api.sifthealth.app/v1/sites/site_a1b2/history \
  -H "Authorization: Bearer $SIFT_API_KEY"

Continuous monitoring

Produce the history.

Multi-location group

Roll up many sites' trends.

List findings

What changed between points.

Monitoring

Set the rescan cadence.