---
title: "Retrieve an iPXE template"
method: GET
path: "/v2/org/{org}/nico/ipxe-template/{ipxeTemplateId}"
tags: ["iPXE Template"]
---

# Retrieve an iPXE template

`GET /v2/org/{org}/nico/ipxe-template/{ipxeTemplateId}`

Retrieve an iPXE template by its stable core ID. The caller must be authorized for at least one Site at which the template is available.

The Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.

## Response `200`

OK

- IpxeTemplate — An iPXE script template propagated (read-only) from nico-core
  - `id` string, uuid, required — Stable template UUID assigned by core
  - `name` string, required — Globally unique template name
  - `template` string, required — Raw iPXE script content
  - `requiredParams` string[], required — Parameters that must be provided to render the template
  - `reservedParams` string[], required — Parameters reserved by the template and not user-supplied
  - `requiredArtifacts` string[], required — Artifact names required for the template
  - `visibility` string, required — Template visibility: Internal or Public
  - `created` string, date-time
  - `updated` string, date-time

## Other responses

- `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects
- `404` — Error response when requested object is not found

## Changes

- **2026-07-23** `af4a60b76e0b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/ipxe-template/:ipxeTemplateId/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-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-infra-controller-rest-api/revisions/c4290aa37b46/schema)