Foundational API providing access to EquipmentWatch's manufacturer and model database, covering the taxonomy used across the broader API suite for construction and heavy equipment. Published operations cover classifications, categories, subtypes, sizes, manufacturers and models.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/taxonomy"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.0.3
info:
title: EquipmentWatch API
version: 1.0.0
description: |
The EquipmentWatch API enables integration of critical equipment data attributes - including
cost, rental, specs and value benchmarks - directly into any software or application.
contact:
url: "https://equipmentwatch.com/api/"
email: customerservice@equipmentwatch.com
paths:
/taxonomy/classifications:
get:
summary: Classifications
description: Classifications
tags:
- Taxonomy
parameters:
- $ref: "#/components/parameters/classificationIdParam"
- $ref: "#/components/parameters/classificationParam"
- $ref: "#/components/parameters/categoryIdParam"
- $ref: "#/components/parameters/categoryParam"
- $ref: "#/components/parameters/subtypeIdParam"
- $ref: "#/components/parameters/subtypeParam"
- $ref: "#/components/parameters/sizeClassIdParam"
- $ref: "#/components/parameters/sizeParam"
- $ref: "#/components/parameters/manufacturerIdParam"
- $ref: "#/components/parameters/manufacturerParam"
- $ref: "#/components/parameters/modelIdParam"
- $ref: "#/components/parameters/modelParam"
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/taxonomy/categories:
get:
tags:
- Taxonomy
summary: Categories
description: Categories
parameters:
- $ref: "#/components/parameters/classificationIdParam"
- $ref: "#/components/parameters/classificationParam"
- $ref: "#/components/parameters/categoryIdParam"
- $ref: "#/components/parameters/categoryParam"
- $ref: "#/components/parameters/subtypeIdParam"
- $ref: "#/components/parameters/subtypeParam"
- $ref: "#/components/parameters/sizeClassIdParam"
- $ref: "#/components/parameters/sizeParam"
- $ref: "#/components/parameters/manufacturerIdParam"
- $ref: "#/components/parameters/manufacturerParam"
- $ref: "#/components/parameters/modelIdParam"
- $ref: "#/components/parameters/modelParam"
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/taxonomy/subtypes:
get:
tags:
- Taxonomy
summary: Subtypes
description: Subtypes
parameters:
- $ref: "#/components/parameters/classificationIdParam"
- $ref: "#/components/parameters/classificationParam"
- $ref: "#/components/parameters/categoryIdParam"
- $ref: "#/components/parameters/categoryParam"
- $ref: "#/components/parameters/subtypeIdParam"
- $ref: "#/components/parameters/subtypeParam"
- $ref: "#/components/parameters/sizeClassIdParam"
- $ref: "#/components/parameters/sizeParam"
- $ref: "#/components/parameters/manufacturerIdParam"
- $ref: "#/components/parameters/manufacturerParam"
- $ref: "#/components/parameters/modelIdParam"
- $ref: "#/components/parameters/modelParam"
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/taxonomy/sizes:
get:
tags:
- Taxonomy
summary: Sizes
description: Sizes
parameters:
- $ref: "#/components/parameters/classificationIdParam"
- $ref: "#/components/parameters/classificationParam"
- $ref: "#/components/parameters/categoryIdParam"
- $ref: "#/components/parameters/categoryParam"
- $ref: "#/components/parameters/subtypeIdParam"
- $ref: "#/components/parameters/subtypeParam"
- $ref: "#/components/parameters/sizeClassIdParam"
- $ref: "#/components/parameters/sizeParam"
- $ref: "#/components/parameters/manufacturerIdParam"
- $ref: "#/components/parameters/manufacturerParam"
- $ref: "#/components/parameters/modelIdParam"
- $ref: "#/components/parameters/modelParam"
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/taxonomy/manufacturers:
get:
tags:
- Taxonomy
summary: Manufacturers
description: Manufacturers
parameters:
- $ref: "#/components/parameters/classificationIdParam"
- $ref: "#/components/parameters/classificationParam"
- $ref: "#/components/parameters/categoryIdParam"
- $ref: "#/components/parameters/categoryParam"
- $ref: "#/components/parameters/subtypeIdParam"
- $ref: "#/components/parameters/subtypeParam"
- $ref: "#/components/parameters/sizeClassIdParam"
- $ref: "#/components/parameters/sizeParam"
- $ref: "#/components/parameters/manufacturerIdParam"
- $ref: "#/components/parameters/manufacturerParam"
- $ref: "#/components/parameters/modelIdParam"
- $ref: "#/components/parameters/modelParam"
- schema:
type: string
in: query
name: partialMatch
description: Partial match manufacturer and model name searches.
required: false
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/taxonomy/models:
get:
tags:
- Taxonomy
summary: Models
description: Models
parameters:
- $ref: "#/components/parameters/classificationIdParam"
- $ref: "#/components/parameters/classificationParam"
- $ref: "#/components/parameters/categoryIdParam"
- $ref: "#/components/parameters/categoryParam"
- $ref: "#/components/parameters/subtypeIdParam"
- $ref: "#/components/parameters/subtypeParam"
- $ref: "#/components/parameters/sizeClassIdParam"
- $ref: "#/components/parameters/sizeParam"
- $ref: "#/components/parameters/manufacturerIdParam"
- $ref: "#/components/parameters/manufacturerParam"
- $ref: "#/components/parameters/modelIdParam"
- $ref: "#/components/parameters/modelParam"
- schema:
type: boolean
in: query
name: partialMatch
description: Partial match manufacturer and model name searches.
required: false
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/values/value:
get:
tags:
- Values
summary: Value
description: Value
parameters:
- $ref: "#/components/parameters/modelIdRequiredParam"
- $ref: "#/components/parameters/yearParam"
- schema:
type: string
in: query
name: usage
description: Asset usage in hours/miles/kilometers.
required: false
- $ref: "#/components/parameters/valueConditionParam"
- schema:
type: string
in: query
name: country
description: Country code.
required: false
- schema:
type: string
in: query
name: region
description: U.S. state or Canada postal abbreviation.
required: false
- schema:
type: string
in: query
name: olvFactor
description: OLV estimation factor
required: false
- $ref: "#/components/parameters/valuesOlvBasisParam"
- schema:
type: string
in: query
name: revisionDate
description: Data collection date in YYYY-MM-DD format.
required: false
responses:
"200":
description: "OK"
/values/trending:
get:
tags:
- Values
summary: Value Trends
description: Value Trends
parameters:
- $ref: "#/components/parameters/modelIdRequiredParam"
- $ref: "#/components/parameters/yearParam"
- schema:
type: string
in: query
name: usage
description: Asset usage in hours/miles/kilometers.
required: false
- $ref: "#/components/parameters/valueConditionParam"
- schema:
type: string
in: query
name: country
description: Country code.
required: false
- schema:
type: string
in: query
name: region
description: U.S. state or Canada postal abbreviation.
required: false
- schema:
type: string
in: query
name: olvFactor
description: OLV estimation factor
required: false
- $ref: "#/components/parameters/valuesOlvBasisParam"
responses:
"200":
description: "OK"
/values/options:
get:
tags:
- Values
summary: Options
description: Options
parameters:
- $ref: "#/components/parameters/sizeClassIdRequiredParam"
- $ref: "#/components/parameters/yearRequiredParam"
- schema:
type: string
in: query
name: optionFamily
description: Option Family name.
required: false
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/values/options/families:
get:
tags:
- Values
summary: Option Families
description: Option Families
parameters:
- $ref: "#/components/parameters/sizeClassIdRequiredParam"
- $ref: "#/components/parameters/yearParam"
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/values/condition:
get:
tags:
- Values
summary: Condition Adjustments
description: Condition Adjustments
parameters:
- $ref: "#/components/parameters/modelIdRequiredParam"
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/values/region:
get:
tags:
- Values
summary: Region Adjustments
description: Region Adjustments
parameters:
- $ref: "#/components/parameters/modelIdRequiredParam"
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/specs/basic:
get:
tags:
- Specifications
summary: Basic Specs
description: Basic Specifications
parameters:
- $ref: "#/components/parameters/modelIdRequiredParam"
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/specs/dimensions:
get:
x-internal: true
tags:
- Specifications
summary: Dimension Specs
parameters:
- $ref: "#/components/parameters/sizeClassIdRequiredParam"
responses:
"200":
description: "OK"
/rental/rentalhouserates:
get:
tags:
- Rental
summary: Rental House Rates
description: Rental House Rates
parameters:
- schema:
type: integer
in: query
name: sizeClassId
description: Size ID. Required if modelId not specified.
required: false
- schema:
type: integer
in: query
name: modelId
description: Model ID. Required if sizeClassId not specified.
required: false
- schema:
type: string
in: query
name: participantCode
description: Participant Code.
required: false
- schema:
type: string
in: query
name: zipCode
description: Zip Code.
required: false
- schema:
type: string
in: query
name: distance
description: Search Radius (mi).
required: false
responses:
"200":
description: "OK"
/rental/rentalhousetaxonomy:
get:
tags:
- Rental
summary: Rental House Taxonomy
description: Rental House Taxonomy
parameters:
- schema:
type: integer
in: query
name: sizeClassId
description: Size Class ID.
required: true
- schema:
type: integer
in: query
name: modelId
description: Model ID.
required: false
- schema:
type: string
in: query
name: participantCode
description: Participant Code.
required: false
- schema:
type: string
in: query
name: participantName
description: Participant Name.
required: false
- schema:
type: string
in: query
name: city
description: City.
required: false
- schema:
type: string
in: query
name: state
description: State.
required: false
- schema:
type: string
in: query
name: zipCode
description: Zip Code.
required: false
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/rental/rentalhouses:
get:
tags:
- Rental
summary: Rental Houses
description: Rental Houses
parameters:
- schema:
type: string
in: query
name: participantCode
description: Participant Code.
required: false
- schema:
type: string
in: query
name: participantName
description: Participant Name.
required: false
- $ref: "#/components/parameters/limitParam"
- $ref: "#/components/parameters/offsetParam"
responses:
"200":
description: "OK"
/rental/rentalrates:
get:
tags:
- Rental
summary: Rental Rates
description: Rental Rates
parameters:
- $ref: "#/components/parameters/sizeClassIdRequiredParam"
- schema:
type: string
in: query
name: region
description: Region.
required: false
- schema:
type: string
in: query
name: state
description: State.
required: false
- schema:
type: string
in: query
name: country
description: country.
required: false
- schema:
type: string
in: query
name: revisionDate
description: Data collection date in YYYY-MM-DD format.
required: false
responses:
"200":
description: "OK"
/verification/serialnumberverification:
get:
tags:
- Verification
summary: Serial Number
description: Serial Number Verification
parameters:
- schema:
type: string
in: query
name: serialNumber
description: Serial Number.
required: true
- $ref: "#/components/parameters/manufacturerParam"
- $ref: "#/components/parameters/modelParam"
- schema:
type: boolean
in: query
name: survey
description: Include survey derrived results.
required: false
responses:
"200":
description: "OK"
/cost/configurations:
get:
tags:
- Cost
summary: Configurations
description: Configurations
parameters:
- schema:
type: integer
in: query
name: modelId
description: Model ID. Required if manufacturerId and subtypeId are not specified.
required: false
- $ref: "#/components/parameters/yearParam"
- schema:
type: integer
in: query
name: manufacturerId
description: Manufacturer ID. Required if modelId is not specified.
required: false
- schema:
type: integer
in: query
name: subtypeId
description: Subtype ID. Required if modelId is not specified.
required: false
- $ref: "#/components/parameters/configurationSequenceParam"
- $ref: "#/components/parameters/costRevisionDateParam"
responses:
"200":
description: "OK"
/cost/cost-recovery:
get:
tags:
- Cost
summary: Cost Recovery
description: Cost Recovery
parameters:
- $ref: "#/components/parameters/modelIdRequiredParam"
- $ref: "#/components/parameters/configurationSequenceRequiredParam"
- $ref: "#/components/parameters/yearParam"
- $ref: "#/components/parameters/costRevisionDateParam"
- schema:
type: string
in: query
name: operatingAdjustment
description: Operating adjustment multiplier. For example, to increase by 5% use 1.05 as the value.
required: false
- schema:
type: string
in: query
name: ownershipAdjustment
description: Ownership adjustment multiplier. For example, to increase by 5% use 1.05 as the value.
required: false
- schema:
type: string
in: query
name: region
description: Region.
required: false
- schema:
type: string
in: query
name: regionId
description: Region Id.
required: false
- schema:
type: string
in: query
name: city
description: City.
required: false
- schema:
type: string
in: query
name: cityId
description: City Id.
required: false
- schema:
type: string
in: query
name: organizationId
description: Organization Id.
required: false
responses:
"200":
description: "OK"
/cost/icr:
get:
tags:
- Cost
summary: ICR
description: Internal Charge Rate
parameters:
- $ref: "#/components/parameters/modelIdRequiredParam"
- $ref: "#/components/parameters/configurationSequenceRequiredParam"
- $ref: "#/components/parameters/costRevisionDateParam"
- schema:
type: string
in: query
name: originalPrice
description: Price for the equipment at the time of purchase (excluding discount, freight, and sales tax).
required: false
- schema:
type: string
in: query
name: fuel
description: Price per gallon of fuel.
required: false
- schema:
type: string
in: query
name: annualUseHours
description: Average hours used per year.
required: false
- schema:
type: string
in: query
name: economicLifeHours
description: Hours of expected use before needing replacement or overhaul.
required: false
- schema:
type: string
in: query
name: salesTax
description: Sales tax percent paid at the time of purchase. For example, use 0.05 to represent 5%.
required: false
- schema:
type: string
in: query
name: freightCosts
description: Amount paid to ship the equipment after purchase.
required: false
- schema:
type: string
in: query
name: discount
description: Percent discounted from the price of the machine. For example, use 0.05 to represent 5%.
required: false
- schema:
type: string
in: query
name: salvage
description: Value at the end of equipment's economic life.
required: false
- schema:
type: string
in: query
name: resaleValue
description: Current market value of the equipment.
required: false
- schema:
type: string
in: query
name: annualOverhead
description: Amount of overhead costs, on average, for the equipment in a given year.
required: false
- schema:
type: string
in: query
name: annualOverhaulLaborHours
description: Number of labor hours, on average, required to overhaul the equipment in a given year.
required: false
- schema:
type: string
in: query
name: annualOverhaulPartsCost
description: Cost of parts, on average, to overhaul the equipment each year.
required: false
- schema:
type: string
in: query
name: annualFieldLaborHours
description: Number of labor hours required, on average, to make regular operating repairs on the equipment each year.
required: false
- schema:
type: string
in: query
name: annualFieldRepairPartsCost
description: Cost of parts, on average, to make regular operating repairs on the equipment each year.
required: false
- schema:
type: string
in: query
name: annualSupplyParts
description: Cost of supply parts, on average, for the equipment each year.
required: false
- schema:
type: string
in: query
name: newTireCost
description: Cost of a new set of tires for the equipment.
required: false
- schema:
type: string
in: query
name: tireLifeHours
description: Number of hours new tires are expected to last before needing replacement.
required: false
- schema:
type: string
in: query
name: annualGEC
description: Average cost for any ground engaging components, repair and/or replacement costs each year.
required: false
- schema:
type: string
in: query
name: primaryFuelConsumption
description: Fuel/Electrical (gph/KWh) consumption of the primary engine of the equipment.
required: false
- schema:
type: string
in: query
name: hourlyLubeCost
description: Cost of lube for the equipment per hour of use.
required: false
- schema:
type: string
in: query
name: mechanicWages
description: Average cost per hour paid to the mechanic.
required: false
responses:
"200":
description: "OK"
/bulk/manufacturers:
get:
tags:
- Bulk
summary: Bulk Manufacturers
description: Bulk Manufacturers
parameters:
- $ref: "#/components/parameters/classificationIdParam"
responses:
"200":
description: "OK"
/bulk/models:
get:
tags:
- Bulk
summary: Bulk Models
description: Bulk Models
parameters:
- $ref: "#/components/parameters/classificationIdParam"
responses:
"200":
description: "OK"
externalDocs:
url: "https://docs.equipmentwatchapi.com/"
servers:
- url: "https://equipmentwatchapi.com/v1"
description: "Primary"
- url: "https://sandbox.equipmentwatchapi.com/v1"
description: "Sandbox"
components:
links: {}
callbacks: {}
parameters:
offsetParam:
schema:
type: integer
minimum: 0
in: query
name: offset
description: >-
Offset is used to skip some number of items before beginning to
return results. If offset is not specified, 0 items will be skipped
in the result by default.
required: false
limitParam:
schema:
type: integer
minimum: 1
maximum: 50
in: query
name: limit
description: >-
Parameter is used to limit the number of results returned in the
response (max 50). If limit is not specified, 50 items will be
returned in the result by default.
required: false
classificationIdParam:
schema:
type: integer
in: query
name: classificationId
description: Classification ID.
required: false
classificationParam:
schema:
type: string
in: query
name: classification
description: Classification name.
required: false
categoryIdParam:
schema:
type: integer
in: query
name: categoryId
description: Category ID.
required: false
categoryParam:
schema:
type: string
in: query
name: category
description: Category name.
required: false
subtypeIdParam:
schema:
type: integer
in: query
name: subtypeId
description: Subtype ID.
required: false
subtypeParam:
schema:
type: string
in: query
name: subtype
description: Subtype name.
required: false
sizeClassIdParam:
schema:
type: integer
in: query
name: sizeClassId
description: Size ID.
required: false
sizeClassIdRequiredParam:
schema:
type: integer
in: query
name: sizeClassId
description: Size ID.
required: true
sizeParam:
schema:
type: string
in: query
name: size
description: Size name.
required: false
manufacturerIdParam:
schema:
type: integer
in: query
name: manufacturerId
description: Manufacturer ID.
required: false
manufacturerParam:
schema:
type: string
in: query
name: manufacturer
description: Manufacturer name.
required: false
modelIdParam:
schema:
type: integer
in: query
name: modelId
description: Model ID.
required: false
modelIdRequiredParam:
schema:
type: integer
in: query
name: modelId
description: Model ID.
required: true
modelParam:
schema:
type: string
in: query
name: model
description: Model name.
required: false
yearParam:
schema:
type: string
in: query
name: year
description: Model year.
required: false
yearRequiredParam:
schema:
type: string
in: query
name: year
description: Model year.
required: true
valueConditionParam:
schema:
type: string
enum: [Excellent, Very Good, Good, Fair, Poor]
in: query
name: condition
description: Asset Condition.
required: false
costRevisionDateParam:
schema:
type: string
in: query
name: date
description: Cost revision date in YYYY-MM-DD format. If not specified, most recent date will be returned.
required: false
configurationSequenceParam:
schema:
type: string
in: query
name: configurationSequence
description: Configuration Sequence.
required: false
configurationSequenceRequiredParam:
schema:
type: string
in: query
name: configurationSequence
description: Configuration Sequence.
required: true
valuesOlvBasisParam:
schema:
type: string
enum: [FMV, FLV]
in: query
name: olvBasis
description: Basis of OLV estimate. "FMV" or "FLV".
required: false
schemas:
ok:
type: object
securitySchemes:
API Key:
type: apiKey
name: x-api-key
in: header
security:
- API Key: []