# List equipment

Read-only catalog of equipment types. The ids are what order and load
equipment arrays reference. The list is system-managed and small —
fetch it once and cache it, or hardcode the ids your integration uses.

The catalog is global and organization-independent: every
authenticated organization sees the same rows.

Endpoint: GET /reference-data/equipment
Version: 1.0.0
Security: BearerAuth

## Query parameters:

  - `categoryId` (string)
    Only return equipment in this category

  - `groupId` (string)
    Only return equipment in this top-level group

  - `subcategoryId` (string)
    Only return equipment in this subcategory

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.id` (string, required)
    Equipment id (referenced by order/load equipment arrays)

  - `data.name` (string, required)
    Display name (e.g., "Van 53'")
    Example: "Van 53'"

  - `data.category` (any)
    Equipment category

  - `data.group` (any)
    Top-level equipment group

  - `data.subcategory` (any)
    Equipment subcategory

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 429 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message