Skip to main content
POST
/
1
/
reporting
/
slos
/
historical
Get SLO History
curl --request POST \
  --url https://api.honeycomb.io/1/reporting/slos/historical \
  --header 'Content-Type: application/json' \
  --header 'X-Honeycomb-Team: <api-key>' \
  --data '
{
  "ids": [
    "2LBq9LckbcA",
    "CzcpPs7cJ4d"
  ],
  "start_time": 1742230800,
  "end_time": 1745254800
}
'
{
  "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
    }
  ]
}

Authorizations

​
X-Honeycomb-Team
string
header
required

A Honeycomb Configuration Key is required to use this API. A Configuration Key can be found in the API Keys section of the environment configuration, which can be found under Environment Settings -> API Keys -> Configuration tab. Check out our documentation to find your API Keys.

More information can be found in Manage Environments.

Body

application/json
​
ids
array
required

A list of SLO IDs to retrieve history for. Cannot be an empty array or more than 24 in length.

Required array length: 1 - 24 elements
Example:
["2LBq9LckbcA", "CzcpPs7cJ4d"]
​
start_time
integer
required

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

Example:

1742230800

​
end_time
integer
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:

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.

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

​
{key}
object[]