Batch Retrieve Daily Availability¶

POST /api/v1/slo/availability/list

Overview¶

Batch retrieve the daily availability of SLOs in the workspace associated with the current API Key.

Body Request Parameters¶

Parameter	Type	Required	Description
sloUUIDs	array	Y	List of SLO UUIDs, up to 100 items Nullable: False
startDate	string	Y	Start business date, format YYYY-MM-DD, inclusive Nullable: False
endDate	string	Y	End business date, format YYYY-MM-DD, inclusive Nullable: False
timezone	string	Y	IANA timezone, e.g. Asia/Shanghai Nullable: False
interval	string		Aggregation granularity, currently only supports `1d` Nullable: False Optional values: ['1d']

Additional Notes on Parameters¶

A maximum of 100 SLOs can be queried in a single request, and the date range can cover up to 90 calendar days.
interval currently only supports 1d.
Each calendar day is divided according to the requested timezone, and availability is calculated based on the actual number of seconds in that calendar day.
For dates without metric data, the response returns availability=null, hasData=false, and level=unknown.
level returns normal, warning, critical, or unknown based on the SLO's goal/minGoal.

Request Example¶

curl 'https://openapi.truewatch.com/api/v1/slo/availability/list' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"sloUUIDs":["monitor_xxx"],"startDate":"2026-05-03","endDate":"2026-07-31","timezone":"Asia/Shanghai","interval":"1d"}'

Response¶

{
    "code": 200,
    "content": {
        "data": [
            {
                "sloUUID": "monitor_xxx",
                "name": "Metrics",
                "status": 0,
                "goal": 99.9,
                "minGoal": 99.5,
                "tagInfo": [
                    {
                        "name": "site:cn1"
                    }
                ],
                "points": [
                    {
                        "date": "2026-07-31",
                        "availability": 99.98,
                        "level": "normal",
                        "hasData": true
                    }
                ]
            }
        ]
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-XXXX"
}