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.
\nThe endpoint accepts the following parameters in the query string:
\nmake: 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.The API returns a JSON object containing valuation details with the following fields:
\nretailConfidenceIntervalHighPriceInCents: 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.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.auctionMaxPriceInCents: The maximum reasonable auction comparable value iu cents.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-streamContent-Disposition: with a value of the file nameWhile this API aims to provide accurate and up-to-date valuation insights, the following factors should be considered:
\nOur API is designed to provide a consistent and reliable service to all users. To ensure this, we have implemented a rate limiting policy that allows a maximum of 10 requests per second.
\nThe rate limit for our API is 10 requests per second (RPS). This rate limit applies per API key, not per user or application.
\nEvery API request you make subtracts from your remaining request quota. If you exceed the limit of 10 requests per second, you will receive a 429 Too Many Requests HTTP status code.
Every API response includes three headers to help you understand your current rate limit status:
\nX-RateLimit-Limit: The maximum number of requests you can make per second.X-RateLimit-Remaining: The number of requests left for the current window.X-RateLimit-Reset: The time when the rate limit will reset, in UTC epoch seconds.When you exceed the rate limit, the API responds with HTTP status 429 Too Many Requests. You should design your application to handle this possibility and implement a backoff strategy. For example, you could wait until the rate limit resets (as specified in the X-RateLimit-Reset header) before making additional requests.
The information provided by this API should be used in conjunction with professional advice and market knowledge to make informed decisions about equipment valuation.
\nThe 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.
\nWe have an optional taxonomizedSubCategorySlug parameter which will ensure that the fuzzy match will only match exclusively to that subcategory.
The make or manufacturer of the equipment.
\n","type":"text/plain"},"key":"make","value":"Caterpillar"},{"description":{"content":"The model of the equipment, ensure that special characters that are not URL friendly are encoded correctly.
\n","type":"text/plain"},"key":"model","value":"259D"},{"description":{"content":"The year the equipment was manufactured.
\n","type":"text/plain"},"key":"year","value":"2019"},{"description":{"content":"The hours or miles the equipment has on its primary meter, some equipment may have several meters, use the primary meter for that model.
\n","type":"text/plain"},"key":"meter","value":"4000"},{"description":{"content":"If provided, this will enable precision search to refine the comparables to determine the estimation.
\n","type":"text/plain"},"key":"taxonomizedSubCategorySlug","value":"skid-steer-loaders"},{"description":{"content":"If true, will download a Excel file with the comparables and detailed analytics. If false, will return a summary of the estimation.
\n","type":"text/plain"},"key":"downloadReport","value":"false"}],"variable":[]}},"response":[{"id":"b89350c5-b537-462d-9db8-5b976fb25e37","name":"2019 Caterpillar 259D","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.boomandbucket.com/valuationservice/valuation/iron-insight/summarized?make=Caterpillar&model=259D&year=2019&meter=5000&downloadReport=false","protocol":"https","host":["api","boomandbucket","com"],"path":["valuationservice","valuation","iron-insight","summarized"],"query":[{"key":"make","value":"Caterpillar"},{"key":"model","value":"259D"},{"key":"year","value":"2019"},{"key":"meter","value":"5000"},{"key":"downloadReport","value":"false"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Wed, 07 Feb 2024 19:13:26 GMT"},{"key":"Server","value":"Kestrel"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Request-Context","value":"appId=cid-v1:3695f997-cc2f-45f0-8294-f170c1613f5c"}],"cookie":[],"responseTime":null,"body":"{\n \"retailConfidenceIntervalHighPriceInCents\": 5678600,\n \"retailConfidenceIntervalLowPriceInCents\": 3311600,\n \"auctionConfidenceIntervalHighPriceInCents\": 3307000,\n \"auctionConfidenceIntervalLowPriceInCents\": 2949400,\n \"retailConfidencePercentage\": 54.58318920788654,\n \"auctionConfidencePercentage\": 11.450161698312574,\n \"retailComparableCount\": 90,\n \"auctionComparableCount\": 90,\n \"retailConfidenceScore\": \"Low\",\n \"auctionConfidenceScore\": \"Medium\"\n}"},{"id":"393be1f0-0c8f-45cc-be76-8f4df5d9aa77","name":"2019 Caterpillar 259D (Precision Search)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.boomandbucket.com/valuationservice/valuation/iron-insight/summarized?make=Caterpillar&model=259D&year=2019&meter=5000&taxonomizedSubCategorySlug=skid-steer-loaders&downloadReport=false","protocol":"https","host":["api","boomandbucket","com"],"path":["valuationservice","valuation","iron-insight","summarized"],"query":[{"key":"make","value":"Caterpillar"},{"key":"model","value":"259D"},{"key":"year","value":"2019"},{"key":"meter","value":"5000"},{"key":"taxonomizedSubCategorySlug","value":"skid-steer-loaders"},{"key":"downloadReport","value":"false"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Wed, 07 Feb 2024 19:13:26 GMT"},{"key":"Server","value":"Kestrel"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Request-Context","value":"appId=cid-v1:3695f997-cc2f-45f0-8294-f170c1613f5c"}],"cookie":[],"responseTime":null,"body":"{\n \"retailConfidenceIntervalHighPriceInCents\": 5017800,\n \"retailConfidenceIntervalLowPriceInCents\": 4329300,\n \"auctionConfidenceIntervalHighPriceInCents\": 2596400,\n \"auctionConfidenceIntervalLowPriceInCents\": 2538300,\n \"retailConfidencePercentage\": 14.772142121524201,\n \"auctionConfidencePercentage\": 2.263166095356809,\n \"retailComparableCount\": 9,\n \"auctionComparableCount\": 5,\n \"retailConfidenceScore\": \"Medium\",\n \"auctionConfidenceScore\": \"High\"\n}"},{"id":"34f97e50-7ba6-4f69-9bce-81f49eb9f24b","name":"2022 Bobcat E26","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.boomandbucket.com/valuationservice/valuation/iron-insight/summarized?make=Bobcat&model=E-26&year=2019&meter=1324&downloadReport=false","protocol":"https","host":["api","boomandbucket","com"],"path":["valuationservice","valuation","iron-insight","summarized"],"query":[{"key":"make","value":"Bobcat"},{"key":"model","value":"E-26"},{"key":"year","value":"2019"},{"key":"meter","value":"1324"},{"key":"taxonomizedSubCategorySlug","value":"mini-excavator","disabled":true},{"key":"downloadReport","value":"false"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Wed, 07 Feb 2024 19:13:26 GMT"},{"key":"Server","value":"Kestrel"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Request-Context","value":"appId=cid-v1:3695f997-cc2f-45f0-8294-f170c1613f5c"}],"cookie":[],"responseTime":null,"body":"{\n \"retailConfidenceIntervalHighPriceInCents\": 3327200,\n \"retailConfidenceIntervalLowPriceInCents\": 3065100,\n \"auctionConfidenceIntervalHighPriceInCents\": 2526900,\n \"auctionConfidenceIntervalLowPriceInCents\": 2005300,\n \"retailConfidencePercentage\": 8.207553078223837,\n \"auctionConfidencePercentage\": 23.17192358951577,\n \"retailComparableCount\": 90,\n \"auctionComparableCount\": 90,\n \"retailConfidenceScore\": \"High\",\n \"auctionConfidenceScore\": \"Medium\"\n}"},{"id":"b60e6854-83c6-46fd-8b91-d7a29ff12695","name":"2019 Ford F750 Flatbed Truck","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.boomandbucket.com/valuationservice/valuation/iron-insight/summarized?make=Ford&model=F750&year=2019&meter=75000&taxonomizedSubCategorySlug=flatbed-trucks&downloadReport=false","protocol":"https","host":["api","boomandbucket","com"],"path":["valuationservice","valuation","iron-insight","summarized"],"query":[{"key":"make","value":"Ford"},{"key":"model","value":"F750"},{"key":"year","value":"2019"},{"key":"meter","value":"75000"},{"key":"taxonomizedSubCategorySlug","value":"flatbed-trucks"},{"key":"downloadReport","value":"false"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Wed, 07 Feb 2024 19:13:26 GMT"},{"key":"Server","value":"Kestrel"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Request-Context","value":"appId=cid-v1:3695f997-cc2f-45f0-8294-f170c1613f5c"}],"cookie":[],"responseTime":null,"body":"{\n \"retailConfidenceIntervalHighPriceInCents\": 3167700,\n \"retailConfidenceIntervalLowPriceInCents\": 2199700,\n \"auctionConfidenceIntervalHighPriceInCents\": 3028500,\n \"auctionConfidenceIntervalLowPriceInCents\": 1323400,\n \"retailConfidencePercentage\": 36.670833806872,\n \"auctionConfidencePercentage\": 85.16983016983018,\n \"retailComparableCount\": 46,\n \"auctionComparableCount\": 13,\n \"retailConfidenceScore\": \"Low\",\n \"auctionConfidenceScore\": \"Low\"\n}"},{"id":"d1061728-bb72-4dbc-be75-6af9a4f0d4f1","name":"2018 KOMATSU PC210 LC-11","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.boomandbucket.com/valuationservice/valuation/iron-insight/summarized?make=KOMATSU&model=PC210 LC-11&year=2018&meter=5000&taxonomizedSubCategorySlug=excavators&downloadReport=true","protocol":"https","host":["api","boomandbucket","com"],"path":["valuationservice","valuation","iron-insight","summarized"],"query":[{"key":"make","value":"KOMATSU"},{"key":"model","value":"PC210 LC-11"},{"key":"year","value":"2018"},{"key":"meter","value":"5000"},{"key":"taxonomizedSubCategorySlug","value":"excavators"},{"key":"downloadReport","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Wed, 07 Feb 2024 19:13:26 GMT"},{"key":"Server","value":"Kestrel"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Request-Context","value":"appId=cid-v1:3695f997-cc2f-45f0-8294-f170c1613f5c"}],"cookie":[],"responseTime":null,"body":"{\n \"retailConfidenceIntervalHighPriceInCents\": 13501200,\n \"retailConfidenceIntervalLowPriceInCents\": 12056100,\n \"auctionConfidenceIntervalHighPriceInCents\": 9839400,\n \"auctionConfidenceIntervalLowPriceInCents\": 8414000,\n \"retailConfidencePercentage\": 11.32683293881582,\n \"auctionConfidencePercentage\": 15.66580208379127,\n \"retailComparableCount\": 90,\n \"auctionComparableCount\": 45,\n \"retailConfidenceScore\": \"Medium\",\n \"auctionConfidenceScore\": \"Medium\"\n}"},{"id":"8b9eee48-5bba-4307-bab1-3f160392e583","name":"2012 John Deere 672G","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.boomandbucket.com/valuationservice/valuation/iron-insight/summarized?make=John DEERE&model=672G&year=2012&meter=15000&downloadReport=false","protocol":"https","host":["api","boomandbucket","com"],"path":["valuationservice","valuation","iron-insight","summarized"],"query":[{"key":"make","value":"John DEERE"},{"key":"model","value":"672G"},{"key":"year","value":"2012"},{"key":"meter","value":"15000"},{"key":"downloadReport","value":"false"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Wed, 07 Feb 2024 19:13:26 GMT"},{"key":"Server","value":"Kestrel"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Request-Context","value":"appId=cid-v1:3695f997-cc2f-45f0-8294-f170c1613f5c"}],"cookie":[],"responseTime":null,"body":"{\n \"retailConfidenceIntervalHighPriceInCents\": 10775700,\n \"retailConfidenceIntervalLowPriceInCents\": 9270900,\n \"auctionConfidenceIntervalHighPriceInCents\": 7196900,\n \"auctionConfidenceIntervalLowPriceInCents\": 5034400,\n \"retailConfidencePercentage\": 15.05552776388194,\n \"auctionConfidencePercentage\": 35.92610436429485,\n \"retailComparableCount\": 87,\n \"auctionComparableCount\": 26,\n \"retailConfidenceScore\": \"Medium\",\n \"auctionConfidenceScore\": \"Low\"\n}"}],"_postman_id":"257612b4-2aa7-4422-bad1-3c886a97bcc9"}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-KEY"},{"key":"value","value":"