---
title: "Get a piece of equipment by ID."
method: GET
path: "/v2/equipment/{organization_equipment_id}"
tags: ["Equipment"]
---

# Get a piece of equipment by ID.

`GET /v2/equipment/{organization_equipment_id}`

## Request

- Base URL: `https://api.encircleapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.encircleapp.com/v2/equipment/{organization_equipment_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/encircleapp/apis/encircle-public-api/docs/v2/equipment/:organization_equipment_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `X-Encircle-Attribution` string
- `X-Encircle-Request` string

## Response `200`

A single `Equipment` object corresponding to the given ID.

- object
  - `id` string, uuid, required: A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
  - `organization_id` string, uuid, required: A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
  - `equipment_type` 'air_mover' | 'dehumidifier' | 'air_scrubber' | 'dryer' | 'heater' | 'other', required
  - `equipment_spec_id` string, uuid, required: A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
  - `manufacturer` string, required
  - `model` string, required
  - `serial_number` string, nullable, required
  - `is_rental` boolean, required
  - `asset_identifier` string, required
  - `is_retired` boolean, required
  - `created` string, date-time, required: A [RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) compliant `date-time` string.
  - `currently_placed_in` object
    - `claim_id` integer, required
    - `structure_id` integer, required
    - `room_id` integer, required

## Other responses

- `400`: Error processing request.
- `401`: Authentication error.
- `404`: Requested resource does not exist.
- `429`: Rate limit exceeded. See the Rate limiting section for details.

## Changes

- **2026-10-28** `2ed23bd529dc`: 3 warning
  - added the new `outpostsyncerror` enum value to the `code` response property for the response status `400`
  - added the new `outpostsyncerror` enum value to the `code` response property for the response status `401`
  - added the new `outpostsyncerror` enum value to the `code` response property for the response status `404`
- **2026-10-15** `cdc86decd2d7`: 1 info
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/encircleapp/apis/encircle-public-api/changes/v2/equipment/:organization_equipment_id/get.md)

---

[API](https://skmtc.dev/encircleapp/apis/encircle-public-api.md) - [All operations](https://skmtc.dev/encircleapp/apis/encircle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/encircleapp/apis/encircle-public-api/revisions/2ed23bd529dc?raw)