Sign in

v1

latestOpenAPI 3.1.0Apache 2.02026-07-2685126228.9 KB
Reporting

Get SLO History

Get a weekly breakdown of historical data for a list of SLOs for a given time range.

post/1/reporting/slos/historical

Request body

start_timeinteger required

The starting Unix timestamp, in seconds since the epoch, to retrieve historical data for. Cannot be more than a year in the past.

end_timeinteger required

The ending Unix timestamp, in seconds since the epoch, to retrieve historical data for. Must be greater than start_time. Cannot be a future timestamp.

Example request

{
  "ids": [
    "2LBq9LckbcA",
    "CzcpPs7cJ4d"
  ],
  "start_time": 1742230800,
  "end_time": 1745254800
}

Response

A mapping from SLO IDs (e.g., "2LBq9LckbcA") to their historical data. Each SLO ID maps to an array of compliance and budget intervals.

Note: An empty array indicates that no historical data was found for the given time range for that SLO.

SLOHistoryResponse required

A mapping from SLO IDs (e.g., "2LBq9LckbcA") to their historical data. Each SLO ID maps to an array of compliance and budget intervals.

Example response

{
  "2LBq9LckbcA": [
    {
      "timestamp": 1744650000,
      "compliance": 91.44851657940663,
      "budget_remaining": 14.48516579406632
    },
    {
      "timestamp": 1744653600,
      "compliance": 97.98746514671242,
      "budget_remaining": 88.13453467953423
    }
  ],
  "CzcpPs7cJ4d": [
    {
      "timestamp": 1744650000,
      "compliance": 93.53414567784128,
      "budget_remaining": -71.02966841186735
    }
  ]
}