---
title: "Get an equipment specification by ID."
method: GET
path: "/v2/equipment_specs/{equipment_spec_id}"
tags: ["Equipment"]
---

# Get an equipment specification by ID.

`GET /v2/equipment_specs/{equipment_spec_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_specs/{equipment_spec_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/encircleapp/apis/encircle-public-api/docs/v2/equipment_specs/:equipment_spec_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 `EquipmentSpec` 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.
  - `equipment_type` 'air_mover' | 'dehumidifier' | 'air_scrubber' | 'dryer' | 'heater' | 'other', required
  - `manufacturer` string, required
  - `model` string, required
  - `xact_charge_code` string, nullable, required
  - `voltage` number, nullable, required
  - `amperage` number, nullable, required
  - `cubic_feet_per_minute` number, nullable, required
  - `hepa_filter_count` integer, nullable, required
  - `carbon_filter_count` number, nullable, required
  - `aham_pints_per_day` number, nullable, 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_specs/:equipment_spec_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/390d8f999da2?raw)