---
title: "Get Backend"
method: GET
path: "/api/configs/backend/{name}"
tags: ["Config API"]
---

# Get Backend

`GET /api/configs/backend/{name}`

## Request

- The document declares no server URL.
- Auth: none declared

Get info for a specific backend.

## Path parameters

- `name` string, required

## Response `200`

Successful Response

- Backend: Object storing backend info.
  - `name` string, required
  - `description` string, required
  - `version` string, required
  - `k8s_uid` string, required
  - `k8s_namespace` string, required
  - `dashboard_url` string, required
  - `grafana_url` string, required
  - `tests` string[], required
  - `scheduler_settings` BackendSchedulerSettings, required: Settings that control the how pods are scheduled in a backend
    - `scheduler_type` 'kai': Defines the type of scheduler used by the backend
    - `scheduler_name` string
    - `scheduler_timeout` integer
  - `node_conditions` BackendNodeConditions, required: Settings for backend node conditions.
    - `rules` object, nullable
    - `prefix` string
  - `last_heartbeat` string, date-time, nullable, required
  - `created_date` string, date-time, required
  - `router_address` string, required
  - `online` boolean, required
  - `router_client_address` string

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-14** `845585a71dbb`: 1 info
  - added the optional property `router_client_address` to the response with the `200` status
- **2026-09-09** `6a9fcaf5bc77`: 1 breaking
  - response property `last_heartbeat` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-08-03** `b9d312a13f5d`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-04-08** `a8157dc3279d`: 2 breaking, 1 warning, 1 info
  - response property `node_conditions/rules` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `scheduler_settings/scheduler_type` response's property type changed from no type to `string` for status `200`
  - added the new `kai` enum value to the `scheduler_settings/scheduler_type` response property for the response status `200`
  - removed `#/components/schemas/BackendSchedulerType` from the `scheduler_settings/scheduler_type` response property `allOf` list for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/configs/backend/:name/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/revisions/845585a71dbb?raw)