METUS API Hub
Products

Schemas


ProductCatalogListResponse

Successful product catalog response
success
​boolean · required
​ProductCatalogItem[] · required
​PaginationMetadata · required

Pagination information

​ErrorObject[] · required

ProductCatalogItem

A single entry in the products catalog
sku
​string · required

Brand model number (SKU)

srn
​string · required

Service reference number

type
​string · required

Human-readable product type

​ProductCatalogLinks · required

HATEOAS links for a catalog item

HATEOAS links for a catalog item
self
​string · required

URL to the full product record at its type-specific endpoint

PairingListSuccessResponse

Successful pairings list response (APIResponseV3 format)
success
​boolean · required
​PairingListData · required

Pairings list with embedded pagination

​ErrorObject[] · required

PairingSuccessResponse

Successful single pairing response (APIResponseV3 format)
success
​boolean · required
​PairingData · required

A product pairing or relationship record

​ErrorObject[] · required

ModelInfo

name
​string · required
abbreviation
​string · required
shortDescription
​string · required
longDescription
​string · required

FamilyInfo

name
​string · required
abbreviation
​string · required

SeriesInfo

name
​string · required
abbreviation
​string · required

UnitAhriInfo

AHRI certification data for a unit. Fields are null when not applicable.
refNum
​string · required

AHRI reference number

type
​string · required

AHRI certification type (e.g. 'Ducted'). Not present in V5 data.

PairingListData

Pairings list with embedded pagination
​PairingData[] · required
​PaginationMetadata · required

Pagination information

PairingData

A product pairing or relationship record
id
​integer · required

Product relationship ID

type
​string · enum · required

Relationship type

Enum values:
Pairing
Standalone
Combinations
​PairingAhriInfo · required

AHRI reference numbers for a pairing

​PairingPerformanceInfo · required

System-level performance data measured for the pairing (IDU+ODU tested together). Null if no performance data is available. All section fields are always present — null when no data exists for that section.

​object · required

Pairing-level certification flags. Each key is a certification name and the value indicates whether the pairing holds that certification.

​PairingProduct[] · minItems: 1 · maxItems: 3 · required

Products in this pairing (1-3 units: P1 always present, P2 for Pairing/Combinations, P3 for Combinations only)

PairingAhriInfo

AHRI reference numbers for a pairing
ducted
​integer · required

AHRI ducted reference number

nonducted
​integer · required

AHRI non-ducted reference number

mixed
​integer · required

AHRI mixed reference number

PairingPerformanceInfo

System-level performance data measured for the pairing (IDU+ODU tested together). Null if no performance data is available. All section fields are always present — null when no data exists for that section.
​object

Efficiency ratings (SEER2, HSPF2, EER2). Dimensionless — fields return a {value} or {min, max} object.

​object

Cooling capacity and power input at standard AHRI test conditions.

​object

Heating capacity and power input at standard AHRI test conditions.

​object

Coefficient of performance at various test conditions. All values are dimensionless numbers.

​object

Sound pressure levels at various fan speeds and conditions (dB (A)).

​object

Airflow rates at various fan speeds and conditions.

​object

System-level electrical performance data.

​object

Other performance data (e.g. connected capacity ranges). Same metric/imperial measurement format.

PairingProduct

A product reference within a pairing (minimal fields + HATEOAS link to full unit record)
id
​integer

Product ID

name
​string

Product name

sku
​string

Brand model number (SKU)

category
​string

Product category

seriesName
​string

Series name

HATEOAS links for a product within a pairing

HATEOAS links for a product within a pairing
self
​string · required

Path to the full unit record

PaginationMetadata

Pagination information
count
​integer · required

Results per page

page
​integer · required

Current page number

offset
​integer · required

Offset in the result set

total
​integer · required

Total matching records

totalPages
​integer · required

Total pages available

ErrorResponse

Error response envelope (APIResponseV3 format)
success
​boolean · required

Always false for errors

data
​null · required

Always null for errors

​ErrorObject[] · required

ErrorObject

A structured error detail
code
​string · required

Machine-readable error code (e.g. VALIDATION, NOT_FOUND, INTERNAL)

message
​string · required

Human-readable error message

MeasurementValue

A single measurement value in one unit system, with either a point value or min/max range, plus an optional unit of measure.
value
​number

Point measurement value

min
​number

Minimum value (for range measurements)

max
​number

Maximum value (for range measurements)

uom
​string

Unit of measure (may be absent for dimensionless values)

Measurement

A measurement expressed in both metric and imperial unit systems.
​MeasurementValue · required

Metric unit value (e.g. W, °C, CMM, mm, kg)

​MeasurementValue · required

Imperial unit value (e.g. Btu/h, °F, CFM, in, lb)

MeasurementMap

A map of named measurement fields. Each key is a camelCase measurement name and the value is a dual metric/imperial measurement object.
​MeasurementValue · required

Metric unit value (e.g. W, °C, CMM, mm, kg)

​MeasurementValue · required

Imperial unit value (e.g. Btu/h, °F, CFM, in, lb)

AirflowSpeedEntry

An airflow or sound reading at a specific fan speed step.
speed
​integer · required

Fan speed step number

​object · required

Measurement at this speed. Either a dual metric/imperial object (for airflow) or a simple value+uom object (for sound pressure).

ProductFeature

A product feature or capability
name
​string · required

Feature name

description
​string

Optional description of the feature

DigitalAsset

A digital asset (document, image, or downloadable file) associated with a product
name
​string · required

Asset name or document title

url
​string · required

URL to the asset

SubmittalNote

A submittal note providing supplementary specification information for a product
noteNumber
​integer · required

Note reference number

description
​string · required

Note text

submittalType
​string · required

Category or type of submittal this note belongs to

superscript
​string

Superscript label that references this note in spec tables

IndoorUnitData

A single an indoor unit product record.
id
​string · required

Internal product ID.

name
​string · required

Product name.

sku
​string · required

Brand model number (SKU).

srn
​string · required

Service reference number.

category
​string · required

Product category (INDOOR or OUTDOOR).

subcategory
​string · required

Product subcategory.

​ModelInfo · required
​FamilyInfo · required
​SeriesInfo · required
brand
​string · required

Brand name.

​UnitAhriInfo · required

AHRI certification data for a unit. Fields are null when not applicable.

​object · required

Certification data.

​ProductFeature[] · required

Product features. Empty array if none.

compatibleControls
​string[] · required

SKUs of compatible controls.

compatibleAccessories
​string[] · required

SKUs of compatible accessories.

​DigitalAsset[] · required

Manuals, submittals, CAD files, and images.

​SubmittalNote[] · required

Submittal notes. Empty array if none.

​IndoorPerformanceInfo · required

Performance data for an indoor unit.

​IndoorSpecificationsInfo · required

Technical specification data for an indoor unit.

IndoorPerformanceInfo

Performance data for an indoor unit.
​object

Efficiency ratings (SEER2, EER2, HSPF2). Dimensionless — fields return a {value} or {min, max} object.

​object

Cooling performance data with capacity and power input at various conditions.

​object

Heating performance data. Heat pumps have capacity/power at various outdoor conditions. Hydrobox/ATW units have booster heater specifications.

​object

Coefficient of performance data. Dimensionless — fields return {value} or {min, max}.

​object

Sound level data. Heat pump units have indoorCooling1-5 and indoorHeating1-5 fields. Hydrobox/ventilation units have indoorPowerLevel (PWL) and indoorPressureLevel (SPL) fields.

​object

Airflow rate data at various fan speeds and conditions.

​object

Airflow and sound data indexed by fan speed step. Keys are mode names (e.g. heating, fanAirflowRate, soundPressureLevel). Each value is an array of speed-step entries.

​object

Electrical performance data including MOCP, MCA, and power consumption.

​object

Electrical specification data (value + uom, value may be a string).

Other performance data (capacity ranges at specific conditions).

IndoorSpecificationsInfo

Technical specification data for an indoor unit.
​object

Compressor specifications.

​object

Fan specifications.

​object

Refrigerant specifications.

​object

Refrigerant and drain piping specifications.

​object

Water-circuit specifications (hydronic units only).

​object

Physical dimensions and material specifications.

​object

Operating temperature and pressure range specifications.

​object

Product feature specifications.

​object

Brand-specific model or part codes.

​object

General specifications.

OutdoorUnitData

A single an outdoor unit product record.
id
​string · required

Internal product ID.

name
​string · required

Product name.

sku
​string · required

Brand model number (SKU).

srn
​string · required

Service reference number.

category
​string · required

Product category (INDOOR or OUTDOOR).

subcategory
​string · required

Product subcategory.

​ModelInfo · required
​FamilyInfo · required
​SeriesInfo · required
brand
​string · required

Brand name.

​UnitAhriInfo · required

AHRI certification data for a unit. Fields are null when not applicable.

​object · required

Certification data.

​ProductFeature[] · required

Product features. Empty array if none.

compatibleControls
​string[] · required

SKUs of compatible controls.

compatibleAccessories
​string[] · required

SKUs of compatible accessories.

​DigitalAsset[] · required

Manuals, submittals, CAD files, and images.

​SubmittalNote[] · required

Submittal notes. Empty array if none.

​OutdoorPerformanceInfo · required

Performance data for an outdoor unit.

​OutdoorSpecificationsInfo · required

Technical specification data for an outdoor unit.

​object · required

Other product attributes (outdoor units). Uses the same mixed measurement format as performance data.

OutdoorPerformanceInfo

Performance data for an outdoor unit.
​object

Efficiency ratings (SEER2, EER2, HSPF2). Dimensionless — fields return a {value} or {min, max} object.

​object

Cooling performance data with capacity and power input at various conditions.

​object

Heating performance data. Heat pumps have capacity/power at various outdoor conditions. Hydrobox/ATW units have booster heater specifications.

​object

Coefficient of performance data. Dimensionless — fields return {value} or {min, max}.

​object

Sound level data.

​object

Airflow rate data at various fan speeds and conditions.

​object

Airflow and sound data indexed by fan speed step. Keys are mode names (e.g. heating, fanAirflowRate, soundPressureLevel). Each value is an array of speed-step entries.

​object

Electrical performance data including MOCP, MCA, and power consumption.

​object

Electrical specification data (value + uom, value may be a string).

Other performance data (e.g. connected capacity ranges).

OutdoorSpecificationsInfo

Technical specification data for an outdoor unit.
​object

Compressor specifications.

​object

Fan specifications.

​object

Refrigerant specifications.

​object

Refrigerant and drain piping specifications.

​object

Water-circuit specifications.

​object

Physical dimensions and material specifications.

​object

Operating temperature and pressure range specifications.

​object

Product feature specifications.

​object

Brand-specific model or part codes.

​object

General specifications.

BranchControllerUnitData

A single a branch controller product record.
id
​string · required

Internal product ID.

name
​string · required

Product name.

sku
​string · required

Brand model number (SKU).

srn
​string · required

Service reference number.

category
​string · required

Product category (INDOOR or OUTDOOR).

subcategory
​string · required

Product subcategory.

​ModelInfo · required
​FamilyInfo · required
​SeriesInfo · required
brand
​string · required

Brand name.

​UnitAhriInfo · required

AHRI certification data for a unit. Fields are null when not applicable.

​object · required

Certification data.

​ProductFeature[] · required

Product features. Empty array if none.

compatibleControls
​string[] · required

SKUs of compatible controls.

compatibleAccessories
​string[] · required

SKUs of compatible accessories.

​DigitalAsset[] · required

Manuals, submittals, CAD files, and images.

​SubmittalNote[] · required

Submittal notes. Empty array if none.

​BranchControllerPerformanceInfo · required

Performance data for a branch controller.

​BranchControllerSpecificationsInfo · required

Technical specification data for a BC controller.

BranchControllerPerformanceInfo

Performance data for a branch controller.
​object

Sound level data.

​object

Electrical data including MOCP, MCA, and power consumption.

BranchControllerSpecificationsInfo

Technical specification data for a BC controller.
​object

Refrigerant specifications.

​object

Piping connection specifications.

​object

Physical dimensions and material specifications.

​object

Product feature specifications.

​object

Brand-specific model or part codes.

​object

General specifications.

BranchBoxUnitData

A single a branch box product record.
id
​string · required

Internal product ID.

name
​string · required

Product name.

sku
​string · required

Brand model number (SKU).

srn
​string · required

Service reference number.

category
​string · required

Product category (INDOOR or OUTDOOR).

subcategory
​string · required

Product subcategory.

​ModelInfo · required
​FamilyInfo · required
​SeriesInfo · required
brand
​string · required

Brand name.

​UnitAhriInfo · required

AHRI certification data for a unit. Fields are null when not applicable.

​object · required

Certification data.

​DigitalAsset[] · required

Manuals, submittals, CAD files, and images.

​SubmittalNote[] · required

Submittal notes. Empty array if none.

​BranchBoxPerformanceInfo · required

Performance data for a branch box.

​BranchBoxSpecificationsInfo · required

Technical specification data for a branch box.

BranchBoxPerformanceInfo

Performance data for a branch box.
​object

Electrical data for the branch box.

BranchBoxSpecificationsInfo

Technical specification data for a branch box.
​object

Refrigerant piping connection sizes per side.

​object

Physical dimensions and material specifications.

​object

Brand-specific model or part codes.

​object

General specifications.

VentilationUnitData

A single a ventilation unit product record.
id
​string · required

Internal product ID.

name
​string · required

Product name.

sku
​string · required

Brand model number (SKU).

srn
​string · required

Service reference number.

category
​string · required

Product category (INDOOR or OUTDOOR).

subcategory
​string · required

Product subcategory.

​ModelInfo · required
​FamilyInfo · required
​SeriesInfo · required
brand
​string · required

Brand name.

​UnitAhriInfo · required

AHRI certification data for a unit. Fields are null when not applicable.

​object · required

Certification data.

​ProductFeature[] · required

Product features. Empty array if none.

compatibleControls
​string[] · required

SKUs of compatible controls.

compatibleAccessories
​string[] · required

SKUs of compatible accessories.

​DigitalAsset[] · required

Manuals, submittals, CAD files, and images.

​SubmittalNote[] · required

Submittal notes. Empty array if none.

​VentilationPerformanceInfo · required

Performance data for a ventilation unit.

​VentilationSpecificationsInfo · required

Technical specification data for a ventilation unit.

VentilationPerformanceInfo

Performance data for a ventilation unit.
​object

Sound level data for ventilation units.

​object

Airflow and sound data indexed by fan speed step. Keys are mode names (e.g. heating, fanAirflowRate, soundPressureLevel). Each value is an array of speed-step entries.

​object

Electrical data for the ventilation unit.

Other performance data (e.g. capacity ranges).

VentilationSpecificationsInfo

Technical specification data for a ventilation unit.
​object

Fan specifications.

​object

Physical dimensions and material specifications.

​object

Operating temperature and pressure range specifications.

​object

Product feature specifications.

​object

Brand-specific model or part codes.

​object

General specifications.

AccessoryUnitData

A single an accessory product record.
id
​string · required

Internal product ID.

name
​string · required

Product name.

sku
​string · required

Brand model number (SKU).

srn
​string · required

Service reference number.

category
​string · required

Product category (INDOOR or OUTDOOR).

subcategory
​string · required

Product subcategory.

​ModelInfo · required
​FamilyInfo · required
​SeriesInfo · required
brand
​string · required

Brand name.

​UnitAhriInfo · required

AHRI certification data for a unit. Fields are null when not applicable.

​object · required

Certification data.

​ProductFeature[] · required

Product features. Empty array if none.

​DigitalAsset[] · required

Manuals, submittals, CAD files, and images.

​AccessoryPerformanceInfo · required

Performance data for an accessory.

​AccessorySpecificationsInfo · required

Technical specification data for an accessory.

AccessoryPerformanceInfo

Performance data for an accessory.
​object

Electrical data for the accessory.

AccessorySpecificationsInfo

Technical specification data for an accessory.
​object

Refrigerant specifications.

​object

Piping specifications where applicable.

​object

Physical dimensions and material specifications.

​object

Operating range specifications.

​object

Product feature specifications.

​object

Brand-specific model or part codes.

​object

General specifications.

TextValue

string

A text attribute value.