---
title: "GET /valve/getValve/{id}"
method: GET
path: "/valve/getValve/{id}"
tags: ["ValveService"]
---

# GET /valve/getValve/{id}

`GET /valve/getValve/{id}`

## Path parameters

- `id` string, required

## Response `200`

OK

- GetValveResponse
  - `valve` Valve
    - `id` string
    - `name` string
    - `connectionId` string — internal ID to identify the valve and base station bond
    - `photo` Photo
      - `id` string
      - `default` boolean — true if this is actually the default valve photo
    - `state` ValveState — Valves are async devices. The state contains the desired changes as well as then current state of the device.
      - `reportedState` ValveReportedState — The current state of the valve
        - `connected` boolean
        - `defaultRuntimeSeconds` integer
        - `lastWateringAction` WateringAction
          - `start` string, date-time
          - `durationSeconds` integer
          - `reason` 'QUICK_RUN' | 'BUTTON_PRESS' | 'PROGRAM', enum
          - `programId` string — Only present if the valve is open due to a program.
          - `flowDetected` boolean
        - `lastSeen` string, date-time
        - `batteryStatus` 'GOOD' | 'REPLACE' | 'LOW' | 'UNKNOWN', enum
        - `firmwareVersion` string
        - `calendarHash` string — An internal representation of the valve calendar data. This changes when programs or skips are adjusted
      - `desiredState` ValveDesiredState — The desired values for the valve to sync
        - `defaultRuntimeSeconds` integer
        - `calendarHash` string — An internal representation of the valve calendar data. This changes when programs or skips are adjusted
      - `matches` boolean — True if the reported state matches all desired changes. Note that if these are out of sync (matches = false) then you should wait until the physical valve has time to sync (matches = true) before modifying programs
    - `color` 'LIGHT_BLUE' | 'PURPLE' | 'GREEN' | 'ORANGE' | 'TEAL' | 'YELLOW' | 'BLUE' | 'PINK', enum
    - `detectFlow` boolean
    - `created` string, date-time
    - `updated` string, date-time

---

[API](https://skmtc.net/rach/apis/smart-hose-timer.md) · [All operations](https://skmtc.net/rach/apis/smart-hose-timer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rach/smart-hose-timer/versions/990335185e30/schema)