---
title: "Get a single button layout"
method: GET
path: "/button_layouts/{button_layout_id}"
tags: ["Registers"]
---

# Get a single button layout

`GET /button_layouts/{button_layout_id}`

Returns a single button layout by id.
Button layouts define the arrangement of quick key buttons on a register.

🔒 Requires: `registers:read` scope

## Path parameters

- `button_layout_id` string, uuid, required

## Response `200`

A single ButtonLayout wrapped in a data object

- ButtonLayout
  - `deletedAt` string, date-time, nullable
  - `id` string, required — Autogenerated object identifier.
  - `name` string, required — The name of the button layout.
  - `nodes` ButtonLayoutNode[], required — The nodes that make up the button layout.
    - `attributes` ButtonLayoutNodeAttribute[], required — The attributes associated with this node.
      - `key` string, required — The attribute key.
      - `value` string, required — The attribute value.
    - `id` string, required — Autogenerated object identifier.
    - `parentNodeId` string, uuid, nullable — The ID of the parent node, if applicable.
    - `position` integer, required — The position of the node within its parent.
    - `productId` string, nullable — The product ID associated with this node, if applicable.
  - `version` integer, required — Auto-incrementing object version number.

## Other responses

- `404` — ButtonLayout not found

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)