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

# Retrieve Machine label keys

`GET /v2/org/{org}/nico/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/machine/label/key`
- Auth: HTTP bearer

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

Infrastructure Provider callers receive keys from their Provider's Machines. Tenant Admin callers receive keys only from Sites where `TargetedInstanceCreation` is effective. For organizations with both roles, Provider scope takes precedence, so privileged Tenant Sites owned by other Providers are excluded. 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/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)