---
title: "Get All Discrete Ancillaries"
method: GET
path: "/v1/ancillaries/discrete"
tags: ["ancillaries"]
---

# Get All Discrete Ancillaries

`GET /v1/ancillaries/discrete`

## 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/ancillaries/discrete`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

This endpoint retrieves all discrete ancillaries that the current user has access to.
If the 'only_editable' query parameter is true, the endpoint only returns ancillaries that the user has permission to edit.
If the 'only_editable' query parameter is false, the endpoint returns all ancillaries that are public.
If the 'include_epa' query parameter is false, the front/side/rear EPA is not calculated and is left as null.
Callers that don't display EPA (e.g. the mount builder catalogue) should pass false to skip the per-ancillary calculation.

## Query parameters

- `only_editable` boolean, required
- `include_epa` boolean

## Response `200`

Successful Response

- DiscreteAncillaryView[]
  - `id` integer, required
  - `name` string, required
  - `ancillaryType` string, required
  - `weightKG` number, required
  - `defaultMountOption` string, required
  - `geometries` DiscreteAncillaryGeometryView[], required
    - `geometryType` string, required
    - `geometryValue` number, required
  - `organizationId` integer, required
  - `powerDetails` DefaultPowerDetailsView
    - `powerConsumptionKW` number, required
  - `forceCoefficients` ForceCoefficientsView, required
    - `front` number, nullable, required
    - `side` number, nullable, required
    - `rear` number, nullable, required
  - `epa` EpaView
    - `frontM2` number, required
    - `sideM2` number, required
    - `rearM2` number, required
    - `governingM2` number, nullable: The EPA (m²) in the governing wind direction, if available.

## 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)