---
title: "Check Runtime Status"
method: GET
path: "/v1/status"
tags: ["General"]
---

# Check Runtime Status

`GET /v1/status`

Return the status of all connections (http, flight, metrics, opentelemetry) in the runtime.

## Query parameters

- `format` 'json' | 'csv'

## Response `200`

List of connection statuses

- ConnectionDetails[]
  - `endpoint` string, required — The endpoint of the connection (e.g., URL or IP address)
  - `name` string, required — The name of the connection (e.g., "http", "flight", "metrics", "opentelemetry")
  - `status` union, required — Represents the status of a component (e.g. dataset, model, etc). The `Error` variant optionally carries a human-readable error message describing what caused the component to enter the error state. Use [`ComponentStatus::error`] for an error without a message, or [`ComponentStatus::error_with_message`] to include one.
    - 'Initializing' — The component is initializing and not yet ready
    - 'Ready' — The component is ready to accept connections
    - 'Disabled' — The component is disabled and not running
    - object — An error occurred in the component, with an optional error message
      - `Error` string, nullable, required — An error occurred in the component, with an optional error message
    - 'Refreshing' — The component is in the process of refreshing its state
    - 'ShuttingDown' — The component is in the process of shutting down
    - 'NotLoaded' — The component is configured but not loaded yet

## Other responses

- `500` — Error converting to CSV

## Changes

> 53 revisions in range; 26 could not be searched.

- **2025-03-18** `dd94571fef79` — 1 breaking, 6 warning, 1 info
  - the `items/status` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - added the new `Disabled` enum value to the `items/status` response property for the response status `200`
  - added the new `Error` enum value to the `items/status` response property for the response status `200`
  - added the new `Initializing` enum value to the `items/status` response property for the response status `200`
  - …4 more

[Change history](https://skmtc.dev/spiceai/apis/runtime/changes/v1/status/get.md)

---

[API](https://skmtc.dev/spiceai/apis/runtime.md) · [All operations](https://skmtc.dev/spiceai/apis/runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spiceai/runtime/revisions/fb597a4eaa56/schema)