Skip to main content
API Explorer|API Explorer
SLO & Service Quality/SLO
GETSLOSince 1.0SynchronousAuth Required

GetCurrentStatusWithFallback

Get the SLO status with automatic fallback to cached data when the VM is unavailable.

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Request Inputs

Path Parameters

  • sloIdStringRequired

    Identifier of the SLO objective to query with fallback support.

Responses

200 OK

On success, this API returns the following response structure.

  • statusObject

    Current SLO compliance status retrieved from realtime or fallback source.

    • sloIdString

      Identifier of the SLO objective being reported.

      Example: slo-xyz789

    • currentSliLong

      Current measured SLI value within the compliance window.

      Example: 0.9985

    • targetSliLong

      Target SLI value that the objective aims to meet.

      Example: 0.999

    • statusString

      Compliance status: MEETING | AT_RISK | BREACHED.

      Example: MEETING

    • remainingErrorBudgetRatioLong

      Fraction of the error budget still remaining (0.0–1.0).

      Example: 0.65

    • errorBudgetConsumedPctLong

      Percentage of the error budget that has been consumed.

      Example: 35

    • windowStartString

      Start of the current compliance measurement window.

      Example: 2026-01-15T08:00:00Z

    • windowEndString

      End of the current compliance measurement window.

      Example: 2026-01-15T08:00:00Z

    • cachedAtString

      Timestamp when this status was last cached.

      Example: 2026-01-15T08:00:00Z

  • dataSourceString

    Data source used for the status: realtime | stale_cache | estimate.

    Example: realtime

  • cacheAgeSecsString

    Age of the cached data in seconds; zero if data is from realtime.

    Example: 120

  • vmStatusString

    Health state of the VictoriaMetrics backend: healthy | degraded | unavailable.

    Example: healthy

Endpoint

GET/api/v1/slo/objectives/{sloId}/status-safe

/api/v1/slo/objectives/{sloId}/status-safe

Operation ID

GetCurrentStatusWithFallback

Permalink

Request Example

curl -X GET '{host}/api/v1/slo/objectives/{sloId}/status-safe' -H 'Authorization: Bearer {token}'

Response Example

200
{
  "status": {},
  "dataSource": "realtime",
  "cacheAgeSecs": 120,
  "vmStatus": "healthy"
}

Change History

This API has no change history records yet.

View all change history