Skip to main content
POST
Returns whether a product model is on the US Environmental Protection Agency’s current ENERGY STAR certified list, by category and brand, model number, UPC or ENERGY STAR ID, with the certification date, markets and the list’s published efficiency figures. all_categories searches every category but returns no figures. Delisted models are not shown.

​
Authentication

Requires x402 payment in the payment-signature header.

​
Request Body

​
string
required
The product category; all_categories answers whether a model is certified in any category but returns no efficiency figures. One of refrigerators, freezers, dishwashers, clothes_washers, clothes_dryers, combination_washer_dryers, room_air_conditioners, dehumidifiers, room_air_cleaners, electric_cooking_products, televisions, displays, computers, imaging_equipment, telephones, smart_thermostats, ceiling_fans, ventilating_fans, downlights, water_heaters, heat_pumps, geothermal_heat_pumps, furnaces, boilers, pool_pumps, ev_chargers, storm_windows, commercial_refrigerators_freezers, commercial_dishwashers, commercial_ice_machines, commercial_ovens, commercial_fryers, commercial_griddles, commercial_steam_cookers, commercial_hot_food_holding_cabinets, commercial_coffee_brewers, water_coolers, commercial_water_heaters, commercial_boilers, all_categories.
​
string
The brand, matched case-insensitively as part of the listed brand name. 2 to 60 characters.
​
string
The model number, matched as part of the listed model number or additional model designations. Listed model numbers can use * for a variable character, so give the fixed leading part when an exact number does not match. 2 to 40 characters.
​
string
A UPC, matched as part of the listed UPCs.
​
string
The ENERGY STAR Unique ID.
​
integer
The most models to return. From 1 to 25. Defaults to 10.

​
Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
​
string
Durable job ID for audit and lookup
​
string
Job status: completed
​
string
Always product_energy_certification
​
object
The answer, described under Result below
​
object
Where the answer came from and when
​
string
The public body the data comes from. Always US Environmental Protection Agency (ENERGY STAR).
​
string
public when the data comes from a public body, commercial otherwise
​
string
When the lookup was made, as an ISO 8601 UTC time
​
string | null
When the source says the fact was last updated, or null when the source gives no date

​
Result

Nested under data.result.
​
string
The category searched.
​
boolean
Whether at least one currently certified model matched.
​
boolean
Whether more models matched than limit.
​
object[]
Matching currently certified models, newest certification first.
​
string
The ENERGY STAR Unique ID.
​
string | null
The brand. null when the source gives no value.
​
string | null
The model name. null when the source gives no value.
​
string | null
The listed model number; * stands for a variable character. null when the source gives no value.
​
string | null
Additional model designations covered by the listing. null when the source gives no value.
​
string | null
The ENERGY STAR partner that certified the model. null when the source gives no value.
​
string | null
The product category of the list. null when the source gives no value.
​
string | null
The product type within the category. null when the source gives no value.
​
string[]
The listed UPCs.
​
string | null
When the model was certified. null when the source gives no value.
​
string | null
When the model became available on the market. null when the source gives no value.
​
string[]
The markets the certification covers.
​
boolean | null
Whether the model meets the Most Efficient criteria; null when the list does not say.
​
object[]
The list’s published efficiency figures and other columns; empty for all_categories.
​
string
The source column name.
​
string
The published value.
​
number | null
The value as a number when the column is numeric. null when the source gives no value.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

​
Notes

  • Supply at least one of brand, model_number, upc or energy_star_id.
  • Brand and model number match as parts of the listed values; model numbers also match the additional model designations.
  • Listed model numbers may use * for a variable character, so give the fixed leading part when an exact number does not match.
  • Figures are the list’s own columns, so they differ by category.
  • Not found means the model is not on the current list (never certified, or delisted), not that it failed a test.
  • heat_pumps matches the outdoor unit’s brand.
  • The lists refresh daily.
  • The list shows certification status and is not an endorsement.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}