---
title: "Get Linear Placements"
method: GET
path: "/v1/structures/{structure_id}/linear_placements"
tags: ["structures"]
---

# Get Linear Placements

`GET /v1/structures/{structure_id}/linear_placements`

## Request

- Base URL: `https://api.shapemaker.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shapemaker.io/v1/structures/{structure_id}/linear_placements`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

This endpoint lists the site's detailed linear ancillaries: library items
placed over a height range, and the feeders and clusters each route
carries (with their parent route's id).

## Path parameters

- `structure_id` string, required

## Response `200`

Successful Response

- StructureLinearPlacementView[]
  - `id` string, required
  - `linearAncillaryId` integer, required
  - `parentId` string, nullable, required
  - `tenantId` integer, nullable, required
  - `tenantName` string, nullable, required
  - `startAtM` number, required
  - `endAtM` number, required
  - `azimuthDeg` number, nullable, required
  - `shieldingFactor` number, nullable, required
  - `latticeMountingLegsIndices` integer[], nullable, required
  - `fromLeftMm` number, nullable, required
  - `fromFloorMm` number, nullable, required
  - `status` 'INSTALLED' | 'PLANNED' | 'REMOVED' | 'UNKNOWN' | 'MARKED FOR REMOVAL', required
  - `clampWeightKgPerM` number, required
  - `cover` LadderCover, required: A flat steel sheet over an access ladder's face from start to end, usually at its foot to stop people climbing.
    - `startAtM` number, required
    - `endAtM` number, required
    - `thicknessMm` number, required
    - `customWeightKgPerM` number, nullable
  - `shouldAnalyse` boolean, required
  - `name` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/shapemaker/apis/shapemaker-api.md) - [All operations](https://skmtc.dev/shapemaker/apis/shapemaker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shapemaker/apis/shapemaker-api/revisions/b8461cf1236c?raw)