Get Market Report

GET https://api.boomandbucket.com/valuationservice/valuation/iron-insight/summarized?make=Caterpillar&model=259D&year=2019&meter=4000&taxonomizedSubCategorySlug=skid-steer-loaders&downloadReport=false

Description

This API endpoint retrieves summarized valuation insights for heavy equipment based on specific criteria including make, model, year, meter reading, and an option to download a detailed report. It is particularly useful for quickly accessing a summarized view of both retail and auction value estimates for a given piece of equipment.

Request Parameters

The endpoint accepts the following parameters in the query string:

• make: The manufacturer of the equipment.
• model: The specific model of the equipment.
• year: The year of manufacture of the equipment.
• meter: The meter reading (in hours or miles) indicating usage of the equipment.
• taxonomizedSubCategorySlug (optional): provide one of the subcategories that match for this equipment, this enables precision search to match exactly, this is particularly helpful for on-highway equipment.
• downloadReport: A boolean parameter (true or false) indicating whether to download a detailed Excel report instead of a JSON version of the valuation summary.

Response Object

The API returns a JSON object containing valuation details with the following fields:

• retailConfidenceIntervalHighPriceInCents: The upper limit of the retail price estimate in cents.
• retailConfidenceIntervalLowPriceInCents: The lower limit of the retail price estimate in cents.
• auctionConfidenceIntervalHighPriceInCents: The upper limit of the auction price estimate in cents.
• auctionConfidenceIntervalLowPriceInCents: The lower limit of the auction price estimate in cents.
• retailConfidencePercentage: The confidence level of the retail price estimate expressed as a percentage.
• retailConfidenceScore: The confidence level of the retail estimate, expressed in text.
• auctionConfidencePercentage: The confidence level of the auction price estimate expressed as a percentage.
• auctionConfidenceScore: The confidence level of the retail estimate, expressed in text.
• retailComparableCount: The number of comparable equipment pieces used to determine the retail valuation.
• auctionComparableCount: The number of comparable equipment pieces used to determine the auction valuation.
• retailMinPriceInCents: The minimum reasonable retail comparable value in cents.
• retailMaxPriceInCents: The maximum reasonable retail comparable value in cents.
• auctionMinPriceInCents: The minimum reasonable auction comparable value in cents.

Response Headers

When the downloadReport request parameter is set to true, the response will contain the generated report file with the following headers:

• Content-Type: with a value of application/octet-stream

• Content-Disposition: with a value of the file name

Disclaimer for Estimations

While this API aims to provide accurate and up-to-date valuation insights, the following factors should be considered:

1. Variability in Equipment Condition: Valuations are based on standard equipment conditions and may not reflect variations in actual conditions.
2. Data Accuracy: The accuracy of the valuation is dependent on the correctness of the input parameters (make, model, year, and meter reading).
3. Market Fluctuations: Equipment values can fluctuate due to market conditions, which may not be immediately reflected in the estimates.
4. Comparative Data Limitations: The number of comparable equipment pieces affects the confidence level of the valuation. Limited data points can impact the accuracy of the estimate.
5. Use for Guidance: These valuations should be used as a guide and not as the sole basis for investment or transaction decisions. For a more detailed and personalized valuation, consulting with a Boom and Bucket fleet advisor is recommended.

Precision Search (optional)

The default valuation endpoints are very good at matching equipment, and if it can not find exact matches it uses a fuzzy search to find like makes and models to generate the market report.

We have an optional taxonomizedSubCategorySlug parameter which will ensure that the fuzzy match will only match exclusively to that subcategory.

Request Params

RESPONSES

status: OK

{"retailConfidenceIntervalHighPriceInCents":10775700,"retailConfidenceIntervalLowPriceInCents":9270900,"auctionConfidenceIntervalHighPriceInCents":7196900,"auctionConfidenceIntervalLowPriceInCents":5034400,"retailConfidencePercentage":15.05552776388194,"auctionConfidencePercentage":35.92610436429485,"retailComparableCount":87,"auctionComparableCount":26,"retailConfidenceScore":"Medium","auctionConfidenceScore":"Low"}