---
title: "Retrieve Expected Machine label keys"
method: GET
path: "/v2/org/{org}/nico/expected-machine/label/key"
tags: ["Expected Machine"]
---

# Retrieve Expected Machine label keys

`GET /v2/org/{org}/nico/expected-machine/label/key`

## Request

- Base URL: `https://nico-rest-api.nico.svc.cluster.local`
- URL: `https://nico-rest-api.nico.svc.cluster.local/v2/org/{org}/nico/expected-machine/label/key`
- Auth: HTTP bearer

Retrieve paginated, unique, non-null Expected Machine label keys. Results are ordered by key ascending by default before pagination.

Infrastructure Provider callers receive keys from their Provider's Sites. Tenant Admin callers receive keys only from Sites where `TargetedInstanceCreation` is effective. For organizations with both roles, the result is the union of the Provider's Sites and the privileged Tenant Sites. The optional siteId parameter further restricts the result.

## Query parameters

- `siteId` string, uuid
- `pageNumber` integer: One-indexed page number.
- `pageSize` integer
- `orderBy` 'KEY_ASC' | 'KEY_DESC'

## Response `200`

OK

- string[]

## Other responses

- `400`: Error response when request data cannot be validated
- `403`: Error response when user is not authorized to call an endpoint or retrieve/modify objects

## Changes

- **2026-10-15** `293dc126ab73`: 2 info
  - removed the `nico` enum value from the `source` response property for the response status `400`
  - removed the `nico` enum value from the `source` response property for the response status `403`
- **2026-09-29** `78f3b35615a5`: 2 info
  - added the optional property `retryable` to the response with the `400` status
  - added the optional property `retryable` to the response with the `403` status
- **2026-09-10** `b19304099641`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/expected-machine/label/key/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/revisions/db15b7308121?raw)