{ "openapi": "3.1.0", "info": { "title": "POXA Breaker Value API", "summary": "Turn a VIN or UK reg into a sold breaker value.", "version": "1.0.0-early-access", "description": "The Breaker Value API from POXA, now in early access, turns a VIN or UK registration into a sold breaker value: what a car is worth to a breaker when its used parts are sold. For every part it returns a cautious low and an average UK sold price over the last 12 months, how many sold, and a demand rating from 1 to 10 with an estimated time to sell. It adds them up into a low and an average breaker value for the car and takes off any damaged areas you report. It is designed to use the same vehicle matching as Breaker Value search on poxa.co.uk, which is live today, but to price each part from UK sold prices only.\n\nThe Breaker Value API is in early access. We are opening it to a small number of teams first. Request access and we reply within one business day. Need a value today? Breaker Value search on the website is live, with 10 free searches a month.", "termsOfService": "https://poxa.co.uk/legal/terms", "contact": { "name": "POXA", "url": "https://poxa.co.uk/contact-us?subject=Breaker%20Value%20API%20early%20access" } }, "externalDocs": { "description": "Breaker Value API docs", "url": "https://poxa.co.uk/product/breaker-value/api" }, "servers": [ { "url": "https://api.poxa.co.uk/v1", "description": "Early access" } ], "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "Breaker Value", "description": "The Breaker Value API is in early access. We are opening it to a small number of teams first. Request access and we reply within one business day. Need a value today? Breaker Value search on the website is live, with 10 free searches a month.\n\nOne call per car. Send a VIN or UK registration and tell us about any damage. The API returns every part worth taking off the car with a cautious low and an average of what it has sold for in the UK over the last 12 months, how fast it sells, and the total breaker value of the car." } ], "paths": { "/breaker-value": { "post": { "operationId": "createValuation", "tags": [ "Breaker Value" ], "summary": "Value one car from its VIN or UK registration.", "description": "The Breaker Value API is in early access. We are opening it to a small number of teams first. Request access and we reply within one business day. Need a value today? Breaker Value search on the website is live, with 10 free searches a month.\n\nOne call per car. Send a VIN or UK registration and tell us about any damage. The API returns every part worth taking off the car with a cautious low and an average of what it has sold for in the UK over the last 12 months, how fast it sells, and the total breaker value of the car.\n\nHow we value a car:\n\n1. Identify: We decode the VIN, or look it up from the reg.\n2. Match: We work out the parts fitted to that car. Engine and gearbox parts only come from the same engine and gearbox.\n3. Price: Each part is priced from what it has actually sold for in the UK over the last 12 months. One-off highs and lows are left out.\n4. Filter: Parts with no recent sales, and parts worth less than your minimum part value (£40 unless you say otherwise), are left out.\n5. Damage: Parts in the areas you report come off.\n6. Total: What is left is added up into the breaker value of the car.\n\n- A breaker value is what the parts have sold for. It is not a guarantee of what you will make and not a max bid. You still have to strip, store, list and sell them, and not every part sells.\n- Coverage is not 100%. If there is not enough sold evidence to value a car, we return insufficient_data and say so, and you are not charged.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValuationRequest" }, "examples": { "golf": { "summary": "VW Golf Mk7 1.6 TDI, by VIN", "description": "A plain lookup: VIN in, default options, no damage.", "value": { "vin": "WVWZZZAUZFW321566" } }, "fiesta": { "summary": "Ford Fiesta 1.0 EcoBoost, by reg with front-end damage", "description": "Looked up from the number plate. The front end is damaged, so the bonnet, front bumper, wings and headlights come off.", "value": { "reg": "OW65DNU", "damage": [ { "area": "front_end" } ] } }, "bmw": { "summary": "BMW 320d Touring auto, by VIN with min_part_value 0", "description": "min_part_value 0, so parts with an average under £40 are counted too.", "value": { "vin": "WBA8J92050K784114", "min_part_value": 0 } }, "qashqai": { "summary": "Nissan Qashqai 1.5 dCi, by VIN with rear and offside door damage", "description": "Rear damage takes the rear bumper, tailgate and inner rear lights; the outer rear lights are already left out because they average under £40. Offside door damage takes only the right-hand front door, rear door and mirror. Your stock number goes in reference.", "value": { "vin": "SJNFAAJ11U1558070", "damage": [ { "area": "rear" }, { "area": "doors", "side": "offside" } ], "reference": "YARD-1187" } } } } } }, "responses": { "200": { "description": "The valuation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Valuation" }, "examples": { "golf": { "summary": "VW Golf Mk7 1.6 TDI, by VIN", "description": "2015 Volkswagen Golf S BlueMotion Technology TDI 1.6 diesel (WVWZZZAUZFW321566): breaker value £2,481 lowest to £3,863 average across 18 parts. These are real VINs of scrapped cars. The figures were worked out on 12 October 2026 from POXA's UK sold parts data for cars of the same model, engine and body. Each example lists the main parts only, 17 to 22 lines per car, so its totals cover those parts only. A response from the API is matched part by part for the exact car, so its parts list and totals will differ.", "value": { "id": "bv_ex_golf_wvwzzzauzfw321566", "object": "breaker_value", "created": "2026-10-12T09:00:00Z", "reference": null, "vehicle": { "vin": "WVWZZZAUZFW321566", "reg": "GM15EEN", "make": "Volkswagen", "model": "Golf", "generation": "Mk7 (5G)", "variant": "S BlueMotion Technology TDI", "year": 2015, "first_registered": "2015-06-29", "body": "5-door hatchback", "fuel": "diesel", "engine": { "size_cc": 1598, "power_ps": 104, "code": "CLHA" }, "transmission": "6-speed manual", "drive": "FWD", "colour": "black" }, "value": { "currency": "GBP", "vat": "inc", "lowest": 2481.25, "average": 3862.92, "parts": 18, "pieces": 25, "by_sell_time": [ { "within_days": 90, "parts": 16, "lowest": 2427.48, "average": 3769.15 }, { "within_days": 180, "parts": 18, "lowest": 2481.25, "average": 3862.92 }, { "within_days": 365, "parts": 18, "lowest": 2481.25, "average": 3862.92 } ] }, "demand": { "score": 9.4, "tier": "hot", "by_tier": { "hot": { "parts": 14, "lowest": 2310.57, "average": 3593.8 }, "mid": { "parts": 3, "lowest": 144.9, "average": 228.59 }, "low": { "parts": 1, "lowest": 25.78, "average": 40.53 } } }, "damage": { "areas": [], "pieces_removed": 0, "value_removed": { "lowest": 0, "average": 0 } }, "parts": [ { "name": "Engine (complete)", "area": "powertrain", "qty": 1, "oem_numbers": [ "04L100090" ], "lowest": 549.99, "average": 665.62, "sold_12m": 9, "active_listings": 1, "demand": { "score": 10, "tier": "hot", "sells_in_days": 18 } }, { "name": "Front door", "area": "doors", "qty": 2, "oem_numbers": [ "5G4831055AS" ], "lowest": 130.47, "average": 207.86, "sold_12m": 48, "active_listings": 12, "demand": { "score": 10, "tier": "hot", "sells_in_days": 10 } }, { "name": "Rear door", "area": "doors", "qty": 2, "oem_numbers": [ "5G4833055AC" ], "lowest": 126.96, "average": 195.5, "sold_12m": 32, "active_listings": 21, "demand": { "score": 9, "tier": "hot", "sells_in_days": 31 } }, { "name": "Front seat", "area": "interior", "qty": 2, "oem_numbers": [], "lowest": 102.84, "average": 189.34, "sold_12m": 15, "active_listings": 4, "demand": { "score": 9, "tier": "hot", "sells_in_days": 23 } }, { "name": "Bonnet", "area": "front_end", "qty": 1, "oem_numbers": [ "5G0823031J" ], "lowest": 150, "average": 255.43, "sold_12m": 21, "active_listings": 3, "demand": { "score": 10, "tier": "hot", "sells_in_days": 8 } }, { "name": "Front wing", "area": "front_end", "qty": 2, "oem_numbers": [ "5G0821105A", "5G0821106A" ], "lowest": 70.5, "average": 120.29, "sold_12m": 62, "active_listings": 22, "demand": { "score": 10, "tier": "hot", "sells_in_days": 13 } }, { "name": "Headlight", "area": "front_end", "qty": 2, "oem_numbers": [ "5G2941005", "5G2941006" ], "lowest": 60.05, "average": 111.48, "sold_12m": 52, "active_listings": 22, "demand": { "score": 10, "tier": "hot", "sells_in_days": 15 } }, { "name": "Door mirror", "area": "doors", "qty": 2, "oem_numbers": [ "5G2857508BF" ], "lowest": 60, "average": 95.6, "sold_12m": 97, "active_listings": 29, "demand": { "score": 10, "tier": "hot", "sells_in_days": 11 } }, { "name": "Tailgate", "area": "rear", "qty": 1, "oem_numbers": [ "5G6827025AA" ], "lowest": 122.76, "average": 180.62, "sold_12m": 43, "active_listings": 26, "demand": { "score": 9, "tier": "hot", "sells_in_days": 24 } }, { "name": "Front bumper", "area": "front_end", "qty": 1, "oem_numbers": [ "5G0807217BN" ], "lowest": 82.2, "average": 177.92, "sold_12m": 23, "active_listings": 6, "demand": { "score": 10, "tier": "hot", "sells_in_days": 10 } }, { "name": "Rear bumper", "area": "rear", "qty": 1, "oem_numbers": [ "5G6807417AP" ], "lowest": 103.99, "average": 164.98, "sold_12m": 43, "active_listings": 23, "demand": { "score": 10, "tier": "hot", "sells_in_days": 20 } }, { "name": "Turbo", "area": "powertrain", "qty": 1, "oem_numbers": [ "04L253016H" ], "lowest": 99.62, "average": 140.91, "sold_12m": 16, "active_listings": 4, "demand": { "score": 10, "tier": "hot", "sells_in_days": 12 } }, { "name": "Steering wheel", "area": "interior", "qty": 1, "oem_numbers": [ "5G0419091DP" ], "lowest": 70.78, "average": 115.28, "sold_12m": 35, "active_listings": 30, "demand": { "score": 8, "tier": "hot", "sells_in_days": 40 } }, { "name": "Rear light (outer)", "area": "rear", "qty": 2, "oem_numbers": [ "5G0945095M", "5G0945096M" ], "lowest": 28.98, "average": 46.43, "sold_12m": 180, "active_listings": 213, "demand": { "score": 6, "tier": "mid", "sells_in_days": 70 } }, { "name": "Steering rack", "area": "wheels", "qty": 1, "oem_numbers": [ "5Q2423055L" ], "lowest": 58.95, "average": 82.49, "sold_12m": 30, "active_listings": 29, "demand": { "score": 7, "tier": "mid", "sells_in_days": 49 } }, { "name": "ABS pump", "area": "wheels", "qty": 1, "oem_numbers": [ "5Q0614517CL" ], "lowest": 27.99, "average": 53.24, "sold_12m": 51, "active_listings": 77, "demand": { "score": 4, "tier": "mid", "sells_in_days": 110 } }, { "name": "Radio / screen", "area": "interior", "qty": 1, "oem_numbers": [ "5G0919605" ], "lowest": 29.59, "average": 52.9, "sold_12m": 127, "active_listings": 60, "demand": { "score": 10, "tier": "hot", "sells_in_days": 17 } }, { "name": "Instrument cluster", "area": "interior", "qty": 1, "oem_numbers": [ "5G0920961" ], "lowest": 25.78, "average": 40.53, "sold_12m": 54, "active_listings": 96, "demand": { "score": 3, "tier": "low", "sells_in_days": 149 } } ], "removed": [ { "name": "Rear light (inner)", "area": "rear", "qty": 2, "lowest": 20.49, "average": 30.81, "reason": "below_min_part_value" }, { "name": "Front window regulator", "area": "doors", "qty": 2, "lowest": 15.1, "average": 29.69, "reason": "below_min_part_value" }, { "name": "Heater blower motor", "area": "interior", "qty": 1, "lowest": 20.23, "average": 39.92, "reason": "below_min_part_value" } ], "connect": { "connected": false }, "data": { "basis": "sold", "window": { "from": "2025-10-12", "to": "2026-10-11" }, "listings_as_of": "2026-07-24", "source": "POXA UK sold parts data" } } }, "fiesta": { "summary": "Ford Fiesta 1.0 EcoBoost, by reg with front-end damage", "description": "2016 Ford Fiesta Zetec T 1.0 petrol (WF0DXXGAKDFT39046): breaker value £2,094 lowest to £2,938 average across 14 parts, after front-end damage. These are real VINs of scrapped cars. The figures were worked out on 12 October 2026 from POXA's UK sold parts data for cars of the same model, engine and body. Each example lists the main parts only, 17 to 22 lines per car, so its totals cover those parts only. A response from the API is matched part by part for the exact car, so its parts list and totals will differ.", "value": { "id": "bv_ex_fiesta_ow65dnu", "object": "breaker_value", "created": "2026-10-12T09:00:00Z", "reference": null, "vehicle": { "vin": "WF0DXXGAKDFT39046", "reg": "OW65DNU", "make": "Ford", "model": "Fiesta", "generation": "Mk7 facelift (B299)", "variant": "Zetec T", "year": 2016, "first_registered": "2016-02-19", "body": "5-door hatchback", "fuel": "petrol", "engine": { "size_cc": 999, "power_ps": 100, "code": null }, "transmission": "5-speed manual", "drive": "FWD", "colour": "blue" }, "value": { "currency": "GBP", "vat": "inc", "lowest": 2093.88, "average": 2938.37, "parts": 14, "pieces": 21, "by_sell_time": [ { "within_days": 90, "parts": 10, "lowest": 1937.75, "average": 2655.78 }, { "within_days": 180, "parts": 12, "lowest": 2028.93, "average": 2842.31 }, { "within_days": 365, "parts": 12, "lowest": 2028.93, "average": 2842.31 } ] }, "demand": { "score": 8.8, "tier": "hot", "by_tier": { "hot": { "parts": 9, "lowest": 1738.03, "average": 2378.5 }, "mid": { "parts": 2, "lowest": 223.72, "average": 323.01 }, "low": { "parts": 3, "lowest": 132.13, "average": 236.86 } } }, "damage": { "areas": [ { "area": "front_end", "side": "both" } ], "pieces_removed": 6, "value_removed": { "lowest": 422.28, "average": 689.45 } }, "parts": [ { "name": "Engine (complete)", "area": "powertrain", "qty": 1, "oem_numbers": [], "lowest": 871.18, "average": 1054.76, "sold_12m": 28, "active_listings": 2, "demand": { "score": 10, "tier": "hot", "sells_in_days": 8 } }, { "name": "Alloy wheel", "area": "wheels", "qty": 4, "oem_numbers": [ "E1BJ1007AA" ], "lowest": 54.99, "average": 77.64, "sold_12m": 161, "active_listings": 24, "demand": { "score": 10, "tier": "hot", "sells_in_days": 8 } }, { "name": "Rear door", "area": "doors", "qty": 2, "oem_numbers": [ "P8A61A24631KA" ], "lowest": 99.86, "average": 138.64, "sold_12m": 34, "active_listings": 35, "demand": { "score": 7, "tier": "mid", "sells_in_days": 59 } }, { "name": "Front door", "area": "doors", "qty": 2, "oem_numbers": [ "1806115" ], "lowest": 74.75, "average": 128.56, "sold_12m": 53, "active_listings": 32, "demand": { "score": 9, "tier": "hot", "sells_in_days": 23 } }, { "name": "Gearbox (manual)", "area": "powertrain", "qty": 1, "oem_numbers": [], "lowest": 139.2, "average": 205.56, "sold_12m": 38, "active_listings": 11, "demand": { "score": 10, "tier": "hot", "sells_in_days": 11 } }, { "name": "Rear bumper", "area": "rear", "qty": 1, "oem_numbers": [ "1801047" ], "lowest": 120, "average": 147.52, "sold_12m": 41, "active_listings": 16, "demand": { "score": 10, "tier": "hot", "sells_in_days": 14 } }, { "name": "Front seat", "area": "interior", "qty": 2, "oem_numbers": [], "lowest": 33.59, "average": 70.4, "sold_12m": 5, "active_listings": 7, "demand": { "score": 3, "tier": "low", "sells_in_days": 158 } }, { "name": "Turbo", "area": "powertrain", "qty": 1, "oem_numbers": [], "lowest": 83.79, "average": 123.35, "sold_12m": 13, "active_listings": 9, "demand": { "score": 9, "tier": "hot", "sells_in_days": 33 } }, { "name": "Door mirror", "area": "doors", "qty": 2, "oem_numbers": [ "2104882" ], "lowest": 29, "average": 54.86, "sold_12m": 114, "active_listings": 56, "demand": { "score": 10, "tier": "hot", "sells_in_days": 18 } }, { "name": "Tailgate", "area": "rear", "qty": 1, "oem_numbers": [ "1763986" ], "lowest": 50.4, "average": 102.33, "sold_12m": 48, "active_listings": 32, "demand": { "score": 9, "tier": "hot", "sells_in_days": 27 } }, { "name": "ABS pump", "area": "wheels", "qty": 1, "oem_numbers": [ "1874509" ], "lowest": 46, "average": 67.58, "sold_12m": 111, "active_listings": 32, "demand": { "score": 10, "tier": "hot", "sells_in_days": 10 } }, { "name": "Steering rack", "area": "wheels", "qty": 1, "oem_numbers": [ "1877059" ], "lowest": 35.88, "average": 50.87, "sold_12m": 20, "active_listings": 71, "demand": { "score": 1, "tier": "low", "sells_in_days": 365 } }, { "name": "Radio / screen", "area": "interior", "qty": 1, "oem_numbers": [ "2024533" ], "lowest": 24, "average": 45.73, "sold_12m": 118, "active_listings": 184, "demand": { "score": 4, "tier": "mid", "sells_in_days": 116 } }, { "name": "Steering wheel", "area": "interior", "qty": 1, "oem_numbers": [ "2067869" ], "lowest": 29.07, "average": 45.19, "sold_12m": 12, "active_listings": 43, "demand": { "score": 1, "tier": "low", "sells_in_days": 365 } } ], "removed": [ { "name": "Front bumper", "area": "front_end", "qty": 1, "lowest": 150, "average": 245.51, "reason": "damage" }, { "name": "Headlight", "area": "front_end", "qty": 2, "lowest": 49.4, "average": 82.91, "reason": "damage" }, { "name": "Bonnet", "area": "front_end", "qty": 1, "lowest": 102.88, "average": 144.14, "reason": "damage" }, { "name": "Front wing", "area": "front_end", "qty": 2, "lowest": 35.3, "average": 66.99, "reason": "damage" }, { "name": "Front window regulator", "area": "doors", "qty": 2, "lowest": 22.36, "average": 32.36, "reason": "below_min_part_value" }, { "name": "Rear light (outer)", "area": "rear", "qty": 2, "lowest": 24, "average": 30.27, "reason": "below_min_part_value" }, { "name": "Instrument cluster", "area": "interior", "qty": 1, "lowest": 28.99, "average": 39.54, "reason": "below_min_part_value" }, { "name": "Front wiper motor", "area": "misc", "qty": 1, "lowest": 16.84, "average": 27.51, "reason": "below_min_part_value" } ], "connect": { "connected": false }, "data": { "basis": "sold", "window": { "from": "2025-10-12", "to": "2026-10-11" }, "listings_as_of": "2026-07-24", "source": "POXA UK sold parts data" } } }, "bmw": { "summary": "BMW 320d Touring auto, by VIN with min_part_value 0", "description": "2016 BMW 3 Series 320d Edition+ Auto 2.0 diesel (WBA8J92050K784114): breaker value £4,390 lowest to £5,718 average across 17 parts. These are real VINs of scrapped cars. The figures were worked out on 12 October 2026 from POXA's UK sold parts data for cars of the same model, engine and body. Each example lists the main parts only, 17 to 22 lines per car, so its totals cover those parts only. A response from the API is matched part by part for the exact car, so its parts list and totals will differ.", "value": { "id": "bv_ex_bmw_wba8j92050k784114", "object": "breaker_value", "created": "2026-10-12T09:00:00Z", "reference": null, "vehicle": { "vin": "WBA8J92050K784114", "reg": "GU66VYE", "make": "BMW", "model": "3 Series", "generation": "F31", "variant": "320d Edition+ Auto", "year": 2016, "first_registered": "2016-10-05", "body": "5-door estate", "fuel": "diesel", "engine": { "size_cc": 1995, "power_ps": 163, "code": "B47D20" }, "transmission": "8-speed automatic", "drive": "RWD", "colour": "blue" }, "value": { "currency": "GBP", "vat": "inc", "lowest": 4389.69, "average": 5717.99, "parts": 17, "pieces": 25, "by_sell_time": [ { "within_days": 90, "parts": 12, "lowest": 3233.15, "average": 4333.06 }, { "within_days": 180, "parts": 16, "lowest": 4369.75, "average": 5694.35 }, { "within_days": 365, "parts": 17, "lowest": 4389.69, "average": 5717.99 } ] }, "demand": { "score": 6.7, "tier": "mid", "by_tier": { "hot": { "parts": 10, "lowest": 1193.93, "average": 2074.32 }, "mid": { "parts": 5, "lowest": 3107.82, "average": 3537.71 }, "low": { "parts": 2, "lowest": 87.94, "average": 105.96 } } }, "damage": { "areas": [], "pieces_removed": 0, "value_removed": { "lowest": 0, "average": 0 } }, "parts": [ { "name": "Engine (complete)", "area": "powertrain", "qty": 1, "oem_numbers": [ "11002473150" ], "lowest": 1795.5, "average": 1888.5, "sold_12m": 5, "active_listings": 5, "demand": { "score": 5, "tier": "mid", "sells_in_days": 81 } }, { "name": "Headlight (LED)", "area": "front_end", "qty": 2, "oem_numbers": [ "7419632" ], "lowest": 486.3, "average": 560.99, "sold_12m": 8, "active_listings": 7, "demand": { "score": 5, "tier": "mid", "sells_in_days": 95 } }, { "name": "Alloy wheel", "area": "wheels", "qty": 4, "oem_numbers": [ "7845883" ], "lowest": 53.94, "average": 118.62, "sold_12m": 50, "active_listings": 20, "demand": { "score": 10, "tier": "hot", "sells_in_days": 14 } }, { "name": "Front door", "area": "doors", "qty": 2, "oem_numbers": [ "41009628763" ], "lowest": 121.86, "average": 185.12, "sold_12m": 15, "active_listings": 17, "demand": { "score": 6, "tier": "mid", "sells_in_days": 77 } }, { "name": "Bonnet", "area": "front_end", "qty": 1, "oem_numbers": [ "41007290944" ], "lowest": 187.06, "average": 279.26, "sold_12m": 15, "active_listings": 5, "demand": { "score": 10, "tier": "hot", "sells_in_days": 15 } }, { "name": "Front wing", "area": "front_end", "qty": 2, "oem_numbers": [ "7438439", "7438440" ], "lowest": 97.97, "average": 136.85, "sold_12m": 49, "active_listings": 24, "demand": { "score": 10, "tier": "hot", "sells_in_days": 18 } }, { "name": "Front bumper", "area": "front_end", "qty": 1, "oem_numbers": [ "51117397622" ], "lowest": 156.3, "average": 234.34, "sold_12m": 18, "active_listings": 1, "demand": { "score": 10, "tier": "hot", "sells_in_days": 8 } }, { "name": "Door mirror", "area": "doors", "qty": 2, "oem_numbers": [ "7345660" ], "lowest": 68.98, "average": 108.02, "sold_12m": 63, "active_listings": 28, "demand": { "score": 10, "tier": "hot", "sells_in_days": 16 } }, { "name": "Tailgate", "area": "rear", "qty": 1, "oem_numbers": [ "7314180" ], "lowest": 98.47, "average": 192.86, "sold_12m": 8, "active_listings": 2, "demand": { "score": 9, "tier": "hot", "sells_in_days": 23 } }, { "name": "Steering rack", "area": "wheels", "qty": 1, "oem_numbers": [ "32106889133" ], "lowest": 98.99, "average": 181.98, "sold_12m": 25, "active_listings": 4, "demand": { "score": 10, "tier": "hot", "sells_in_days": 9 } }, { "name": "Radio / screen", "area": "interior", "qty": 1, "oem_numbers": [ "6822626" ], "lowest": 52, "average": 147.58, "sold_12m": 65, "active_listings": 59, "demand": { "score": 8, "tier": "hot", "sells_in_days": 44 } }, { "name": "Steering wheel", "area": "interior", "qty": 1, "oem_numbers": [], "lowest": 73.75, "average": 119.52, "sold_12m": 15, "active_listings": 22, "demand": { "score": 4, "tier": "mid", "sells_in_days": 107 } }, { "name": "Driveshaft", "area": "powertrain", "qty": 2, "oem_numbers": [ "7597693", "7597694" ], "lowest": 34, "average": 41.16, "sold_12m": 6, "active_listings": 7, "demand": { "score": 3, "tier": "low", "sells_in_days": 158 } }, { "name": "ABS pump", "area": "wheels", "qty": 1, "oem_numbers": [], "lowest": 29, "average": 43.16, "sold_12m": 24, "active_listings": 13, "demand": { "score": 10, "tier": "hot", "sells_in_days": 21 } }, { "name": "Instrument cluster", "area": "interior", "qty": 1, "oem_numbers": [ "9232895" ], "lowest": 22.25, "average": 37.47, "sold_12m": 20, "active_listings": 31, "demand": { "score": 4, "tier": "mid", "sells_in_days": 116 } }, { "name": "Starter motor", "area": "powertrain", "qty": 1, "oem_numbers": [ "8570846" ], "lowest": 22.45, "average": 30.92, "sold_12m": 6, "active_listings": 1, "demand": { "score": 9, "tier": "hot", "sells_in_days": 30 } }, { "name": "Front wiper motor", "area": "misc", "qty": 1, "oem_numbers": [ "61617260489" ], "lowest": 19.94, "average": 23.64, "sold_12m": 9, "active_listings": 19, "demand": { "score": 2, "tier": "low", "sells_in_days": 218 } } ], "removed": [], "connect": { "connected": false }, "data": { "basis": "sold", "window": { "from": "2025-10-12", "to": "2026-10-11" }, "listings_as_of": "2026-07-24", "source": "POXA UK sold parts data" } } }, "qashqai": { "summary": "Nissan Qashqai 1.5 dCi, by VIN with rear and offside door damage", "description": "2016 Nissan Qashqai N-Tec+ dCi 1.5 diesel (SJNFAAJ11U1558070): breaker value £1,901 lowest to £2,948 average across 14 parts, after rear and offside door damage. These are real VINs of scrapped cars. The figures were worked out on 12 October 2026 from POXA's UK sold parts data for cars of the same model, engine and body. Each example lists the main parts only, 17 to 22 lines per car, so its totals cover those parts only. A response from the API is matched part by part for the exact car, so its parts list and totals will differ.", "value": { "id": "bv_ex_qashqai_sjnfaaj11u1558070", "object": "breaker_value", "created": "2026-10-12T09:00:00Z", "reference": "YARD-1187", "vehicle": { "vin": "SJNFAAJ11U1558070", "reg": "WO65BCV", "make": "Nissan", "model": "Qashqai", "generation": "J11", "variant": "N-Tec+ dCi", "year": 2016, "first_registered": "2016-01-28", "body": "5-door SUV", "fuel": "diesel", "engine": { "size_cc": 1461, "power_ps": 110, "code": "K9K" }, "transmission": "6-speed manual", "drive": "FWD", "colour": "red" }, "value": { "currency": "GBP", "vat": "inc", "lowest": 1900.65, "average": 2948.02, "parts": 14, "pieces": 20, "by_sell_time": [ { "within_days": 90, "parts": 10, "lowest": 1697.67, "average": 2662.47 }, { "within_days": 180, "parts": 13, "lowest": 1873.9, "average": 2904.1 }, { "within_days": 365, "parts": 13, "lowest": 1873.9, "average": 2904.1 } ] }, "demand": { "score": 9, "tier": "hot", "by_tier": { "hot": { "parts": 10, "lowest": 1697.67, "average": 2662.47 }, "mid": { "parts": 2, "lowest": 115.04, "average": 148.04 }, "low": { "parts": 2, "lowest": 87.94, "average": 137.51 } } }, "damage": { "areas": [ { "area": "rear", "side": "both" }, { "area": "doors", "side": "offside" } ], "pieces_removed": 7, "value_removed": { "lowest": 627.57, "average": 1015.6 } }, "parts": [ { "name": "Engine (complete)", "area": "powertrain", "qty": 1, "oem_numbers": [ "1010201Q0G" ], "lowest": 444.59, "average": 574.87, "sold_12m": 10, "active_listings": 2, "demand": { "score": 10, "tier": "hot", "sells_in_days": 17 } }, { "name": "Alloy wheel", "area": "wheels", "qty": 4, "oem_numbers": [ "D03004EA1A" ], "lowest": 45.8, "average": 82.03, "sold_12m": 64, "active_listings": 10, "demand": { "score": 10, "tier": "hot", "sells_in_days": 8 } }, { "name": "Front door", "area": "doors", "qty": 1, "oem_numbers": [ "H01014EAAA" ], "lowest": 120, "average": 276.73, "sold_12m": 25, "active_listings": 13, "demand": { "score": 9, "tier": "hot", "sells_in_days": 25 } }, { "name": "Bonnet", "area": "front_end", "qty": 1, "oem_numbers": [ "F51004EAMA" ], "lowest": 190, "average": 252.33, "sold_12m": 26, "active_listings": 9, "demand": { "score": 10, "tier": "hot", "sells_in_days": 13 } }, { "name": "Rear door", "area": "doors", "qty": 1, "oem_numbers": [], "lowest": 160, "average": 245.03, "sold_12m": 30, "active_listings": 9, "demand": { "score": 10, "tier": "hot", "sells_in_days": 15 } }, { "name": "Headlight", "area": "front_end", "qty": 2, "oem_numbers": [ "260604EA0A" ], "lowest": 80, "average": 122.46, "sold_12m": 46, "active_listings": 10, "demand": { "score": 10, "tier": "hot", "sells_in_days": 10 } }, { "name": "Front wing", "area": "front_end", "qty": 2, "oem_numbers": [ "F31004EAMB", "F31014EAMB" ], "lowest": 69.8, "average": 119.43, "sold_12m": 48, "active_listings": 44, "demand": { "score": 8, "tier": "hot", "sells_in_days": 45 } }, { "name": "Front bumper", "area": "front_end", "qty": 1, "oem_numbers": [ "620224EA0H" ], "lowest": 111.52, "average": 210.76, "sold_12m": 26, "active_listings": 12, "demand": { "score": 10, "tier": "hot", "sells_in_days": 17 } }, { "name": "Gearbox (6-speed manual)", "area": "powertrain", "qty": 1, "oem_numbers": [ "320104EA0B" ], "lowest": 112.01, "average": 180.29, "sold_12m": 10, "active_listings": 4, "demand": { "score": 9, "tier": "hot", "sells_in_days": 22 } }, { "name": "Radio / sat nav", "area": "interior", "qty": 1, "oem_numbers": [ "259154ET1A" ], "lowest": 76.75, "average": 110.56, "sold_12m": 39, "active_listings": 23, "demand": { "score": 9, "tier": "hot", "sells_in_days": 23 } }, { "name": "Driveshaft", "area": "powertrain", "qty": 2, "oem_numbers": [ "391004EA0A" ], "lowest": 38.92, "average": 49.43, "sold_12m": 5, "active_listings": 3, "demand": { "score": 5, "tier": "mid", "sells_in_days": 98 } }, { "name": "Door mirror", "area": "doors", "qty": 1, "oem_numbers": [], "lowest": 61.19, "average": 93.59, "sold_12m": 47, "active_listings": 91, "demand": { "score": 3, "tier": "low", "sells_in_days": 173 } }, { "name": "Steering rack", "area": "wheels", "qty": 1, "oem_numbers": [ "SN18BC0060" ], "lowest": 37.2, "average": 49.18, "sold_12m": 13, "active_listings": 19, "demand": { "score": 4, "tier": "mid", "sells_in_days": 108 } }, { "name": "Steering wheel", "area": "interior", "qty": 1, "oem_numbers": [ "484304EL5B" ], "lowest": 26.75, "average": 43.92, "sold_12m": 6, "active_listings": 31, "demand": { "score": 1, "tier": "low", "sells_in_days": 365 } } ], "removed": [ { "name": "Front door", "area": "doors", "side": "offside", "qty": 1, "lowest": 120, "average": 276.73, "reason": "damage" }, { "name": "Rear door", "area": "doors", "side": "offside", "qty": 1, "lowest": 160, "average": 245.03, "reason": "damage" }, { "name": "Tailgate", "area": "rear", "qty": 1, "lowest": 108, "average": 158.31, "reason": "damage" }, { "name": "Rear bumper", "area": "rear", "qty": 1, "lowest": 118.4, "average": 157.74, "reason": "damage" }, { "name": "Door mirror", "area": "doors", "side": "offside", "qty": 1, "lowest": 61.19, "average": 93.59, "reason": "damage" }, { "name": "Rear light (inner)", "area": "rear", "qty": 2, "lowest": 29.99, "average": 42.1, "reason": "damage" }, { "name": "Rear light (outer)", "area": "rear", "qty": 2, "lowest": 25, "average": 34.47, "reason": "below_min_part_value" }, { "name": "ABS pump", "area": "wheels", "qty": 1, "lowest": 26.25, "average": 36.72, "reason": "below_min_part_value" }, { "name": "Front wiper motor", "area": "misc", "qty": 1, "lowest": 24.5, "average": 29.87, "reason": "below_min_part_value" }, { "name": "Instrument cluster", "area": "interior", "qty": 1, "lowest": 20.19, "average": 27.75, "reason": "below_min_part_value" } ], "connect": { "connected": false }, "data": { "basis": "sold", "window": { "from": "2025-10-12", "to": "2026-10-11" }, "listings_as_of": "2026-07-24", "source": "POXA UK sold parts data" } } } } } } }, "400": { "$ref": "#/components/responses/InvalidRequest" }, "401": { "$ref": "#/components/responses/Unauthorised" }, "402": { "$ref": "#/components/responses/QuotaExceeded" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/InsufficientData" }, "429": { "$ref": "#/components/responses/RateLimited" }, "500": { "$ref": "#/components/responses/ServerError" } } } }, "/breaker-value/{id}": { "get": { "operationId": "getValuation", "tags": [ "Breaker Value" ], "summary": "Fetch a valuation again by its id, for 30 days.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "The id of a valuation.", "schema": { "type": "string" }, "example": "bv_ex_golf_wvwzzzauzfw321566" } ], "responses": { "200": { "description": "The valuation, as first returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Valuation" }, "examples": { "golf": { "summary": "VW Golf Mk7 1.6 TDI, by VIN", "value": { "id": "bv_ex_golf_wvwzzzauzfw321566", "object": "breaker_value", "created": "2026-10-12T09:00:00Z", "reference": null, "vehicle": { "vin": "WVWZZZAUZFW321566", "reg": "GM15EEN", "make": "Volkswagen", "model": "Golf", "generation": "Mk7 (5G)", "variant": "S BlueMotion Technology TDI", "year": 2015, "first_registered": "2015-06-29", "body": "5-door hatchback", "fuel": "diesel", "engine": { "size_cc": 1598, "power_ps": 104, "code": "CLHA" }, "transmission": "6-speed manual", "drive": "FWD", "colour": "black" }, "value": { "currency": "GBP", "vat": "inc", "lowest": 2481.25, "average": 3862.92, "parts": 18, "pieces": 25, "by_sell_time": [ { "within_days": 90, "parts": 16, "lowest": 2427.48, "average": 3769.15 }, { "within_days": 180, "parts": 18, "lowest": 2481.25, "average": 3862.92 }, { "within_days": 365, "parts": 18, "lowest": 2481.25, "average": 3862.92 } ] }, "demand": { "score": 9.4, "tier": "hot", "by_tier": { "hot": { "parts": 14, "lowest": 2310.57, "average": 3593.8 }, "mid": { "parts": 3, "lowest": 144.9, "average": 228.59 }, "low": { "parts": 1, "lowest": 25.78, "average": 40.53 } } }, "damage": { "areas": [], "pieces_removed": 0, "value_removed": { "lowest": 0, "average": 0 } }, "parts": [ { "name": "Engine (complete)", "area": "powertrain", "qty": 1, "oem_numbers": [ "04L100090" ], "lowest": 549.99, "average": 665.62, "sold_12m": 9, "active_listings": 1, "demand": { "score": 10, "tier": "hot", "sells_in_days": 18 } }, { "name": "Front door", "area": "doors", "qty": 2, "oem_numbers": [ "5G4831055AS" ], "lowest": 130.47, "average": 207.86, "sold_12m": 48, "active_listings": 12, "demand": { "score": 10, "tier": "hot", "sells_in_days": 10 } }, { "name": "Rear door", "area": "doors", "qty": 2, "oem_numbers": [ "5G4833055AC" ], "lowest": 126.96, "average": 195.5, "sold_12m": 32, "active_listings": 21, "demand": { "score": 9, "tier": "hot", "sells_in_days": 31 } }, { "name": "Front seat", "area": "interior", "qty": 2, "oem_numbers": [], "lowest": 102.84, "average": 189.34, "sold_12m": 15, "active_listings": 4, "demand": { "score": 9, "tier": "hot", "sells_in_days": 23 } }, { "name": "Bonnet", "area": "front_end", "qty": 1, "oem_numbers": [ "5G0823031J" ], "lowest": 150, "average": 255.43, "sold_12m": 21, "active_listings": 3, "demand": { "score": 10, "tier": "hot", "sells_in_days": 8 } }, { "name": "Front wing", "area": "front_end", "qty": 2, "oem_numbers": [ "5G0821105A", "5G0821106A" ], "lowest": 70.5, "average": 120.29, "sold_12m": 62, "active_listings": 22, "demand": { "score": 10, "tier": "hot", "sells_in_days": 13 } }, { "name": "Headlight", "area": "front_end", "qty": 2, "oem_numbers": [ "5G2941005", "5G2941006" ], "lowest": 60.05, "average": 111.48, "sold_12m": 52, "active_listings": 22, "demand": { "score": 10, "tier": "hot", "sells_in_days": 15 } }, { "name": "Door mirror", "area": "doors", "qty": 2, "oem_numbers": [ "5G2857508BF" ], "lowest": 60, "average": 95.6, "sold_12m": 97, "active_listings": 29, "demand": { "score": 10, "tier": "hot", "sells_in_days": 11 } }, { "name": "Tailgate", "area": "rear", "qty": 1, "oem_numbers": [ "5G6827025AA" ], "lowest": 122.76, "average": 180.62, "sold_12m": 43, "active_listings": 26, "demand": { "score": 9, "tier": "hot", "sells_in_days": 24 } }, { "name": "Front bumper", "area": "front_end", "qty": 1, "oem_numbers": [ "5G0807217BN" ], "lowest": 82.2, "average": 177.92, "sold_12m": 23, "active_listings": 6, "demand": { "score": 10, "tier": "hot", "sells_in_days": 10 } }, { "name": "Rear bumper", "area": "rear", "qty": 1, "oem_numbers": [ "5G6807417AP" ], "lowest": 103.99, "average": 164.98, "sold_12m": 43, "active_listings": 23, "demand": { "score": 10, "tier": "hot", "sells_in_days": 20 } }, { "name": "Turbo", "area": "powertrain", "qty": 1, "oem_numbers": [ "04L253016H" ], "lowest": 99.62, "average": 140.91, "sold_12m": 16, "active_listings": 4, "demand": { "score": 10, "tier": "hot", "sells_in_days": 12 } }, { "name": "Steering wheel", "area": "interior", "qty": 1, "oem_numbers": [ "5G0419091DP" ], "lowest": 70.78, "average": 115.28, "sold_12m": 35, "active_listings": 30, "demand": { "score": 8, "tier": "hot", "sells_in_days": 40 } }, { "name": "Rear light (outer)", "area": "rear", "qty": 2, "oem_numbers": [ "5G0945095M", "5G0945096M" ], "lowest": 28.98, "average": 46.43, "sold_12m": 180, "active_listings": 213, "demand": { "score": 6, "tier": "mid", "sells_in_days": 70 } }, { "name": "Steering rack", "area": "wheels", "qty": 1, "oem_numbers": [ "5Q2423055L" ], "lowest": 58.95, "average": 82.49, "sold_12m": 30, "active_listings": 29, "demand": { "score": 7, "tier": "mid", "sells_in_days": 49 } }, { "name": "ABS pump", "area": "wheels", "qty": 1, "oem_numbers": [ "5Q0614517CL" ], "lowest": 27.99, "average": 53.24, "sold_12m": 51, "active_listings": 77, "demand": { "score": 4, "tier": "mid", "sells_in_days": 110 } }, { "name": "Radio / screen", "area": "interior", "qty": 1, "oem_numbers": [ "5G0919605" ], "lowest": 29.59, "average": 52.9, "sold_12m": 127, "active_listings": 60, "demand": { "score": 10, "tier": "hot", "sells_in_days": 17 } }, { "name": "Instrument cluster", "area": "interior", "qty": 1, "oem_numbers": [ "5G0920961" ], "lowest": 25.78, "average": 40.53, "sold_12m": 54, "active_listings": 96, "demand": { "score": 3, "tier": "low", "sells_in_days": 149 } } ], "removed": [ { "name": "Rear light (inner)", "area": "rear", "qty": 2, "lowest": 20.49, "average": 30.81, "reason": "below_min_part_value" }, { "name": "Front window regulator", "area": "doors", "qty": 2, "lowest": 15.1, "average": 29.69, "reason": "below_min_part_value" }, { "name": "Heater blower motor", "area": "interior", "qty": 1, "lowest": 20.23, "average": 39.92, "reason": "below_min_part_value" } ], "connect": { "connected": false }, "data": { "basis": "sold", "window": { "from": "2025-10-12", "to": "2026-10-11" }, "listings_as_of": "2026-07-24", "source": "POXA UK sold parts data" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorised" }, "404": { "description": "No valuation with that id for your account, or it is more than 30 days old.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "not_found": { "value": { "error": { "code": "not_found", "message": "No valuation or batch with that id, or it is more than 30 days old.", "request_id": "req_01example" } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "500": { "$ref": "#/components/responses/ServerError" } } } }, "/breaker-value/batch": { "post": { "operationId": "createBatch", "tags": [ "Breaker Value" ], "summary": "Value up to 500 cars in one request, for auction lists.", "description": "For auction lists, send up to 500 cars in one request. The batch runs in the background. Poll it, or give us a webhook_url and we post the results when it finishes.\n\nEach car in a batch takes the same fields as a single valuation. min_part_value, vat and detail at the top of the batch are the defaults for every car. Results come back with detail summary unless you ask for full. Each car valued counts as one valuation.\n\nA batch is queued, then running, then complete. GET /v1/breaker-value/batch/{id} returns its status and a results list with one entry per car: your reference and either the valuation or an error. The webhook receives the same body once the batch is complete.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchRequest" }, "examples": { "auction": { "summary": "Two auction lots", "value": { "vehicles": [ { "reg": "GM15EEN", "reference": "LOT-1042" }, { "vin": "WBA8J92050K784114", "reference": "LOT-1043", "damage": [ { "area": "front_end" } ] } ], "min_part_value": 40, "webhook_url": "https://example.com/hooks/poxa" } } } } } }, "responses": { "202": { "description": "Batch accepted. It runs in the background.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Batch" }, "examples": { "queued": { "value": { "id": "bvb_01example", "status": "queued", "vehicles": 2 } } } } } }, "400": { "$ref": "#/components/responses/InvalidRequest" }, "401": { "$ref": "#/components/responses/Unauthorised" }, "402": { "$ref": "#/components/responses/QuotaExceeded" }, "429": { "$ref": "#/components/responses/RateLimited" }, "500": { "$ref": "#/components/responses/ServerError" } } } }, "/breaker-value/batch/{id}": { "get": { "operationId": "getBatch", "tags": [ "Breaker Value" ], "summary": "Check a batch and read its results.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "The id of an accepted batch.", "schema": { "type": "string" }, "example": "bvb_01example" } ], "responses": { "200": { "description": "The batch and, once complete, its results.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Batch" } } } }, "401": { "$ref": "#/components/responses/Unauthorised" }, "404": { "description": "No batch with that id for your account, or it is more than 30 days old.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "not_found": { "value": { "error": { "code": "not_found", "message": "No valuation or batch with that id, or it is more than 30 days old.", "request_id": "req_01example" } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "500": { "$ref": "#/components/responses/ServerError" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "bv_live_ or bv_test_ API key", "description": "Every request carries your API key as a bearer token. Keys are tied to your POXA account. Live keys start bv_live_.\n\nWhen we issue your early access key you will also get a test key (bv_test_). It is planned to return the four example responses on this page at no cost, so you can build against the response shape first.\n\nKeep keys on your server. Never put them in a web page or an app that runs on a customer’s device." } }, "schemas": { "ValuationRequest": { "type": "object", "description": "Send vin or reg. Everything else is optional.", "anyOf": [ { "required": [ "vin" ] }, { "required": [ "reg" ] } ], "properties": { "vin": { "type": "string", "description": "17-character VIN. Spaces are ignored. Letters I, O and Q are not used in VINs.", "examples": [ "WVWZZZAUZFW321566" ] }, "reg": { "type": "string", "description": "UK registration (number plate). Spaces are ignored. We look up the VIN for you.", "examples": [ "OW65DNU" ] }, "damage": { "type": "array", "description": "Areas of the car that are damaged. Parts in a listed area come off the value. See Damage.", "default": [], "items": { "$ref": "#/components/schemas/DamageItem" } }, "min_part_value": { "type": "number", "minimum": 0, "default": 40, "description": "Leave out parts whose average sold price is under this many pounds. 0 counts every part with sales." }, "vat": { "type": "string", "enum": [ "inc", "ex" ], "default": "inc", "description": "inc returns prices as buyers paid them. ex returns them with VAT removed (divided by 1.20)." }, "detail": { "type": "string", "enum": [ "full", "summary" ], "default": "full", "description": "full lists every part. summary leaves out parts and removed." }, "reference": { "type": "string", "maxLength": 64, "description": "Your stock or lot number, up to 64 characters. Returned as sent. Planned: with a connected yard system, your stock number will let us compare the valuation with what the car really makes." } } }, "DamageItem": { "type": "object", "required": [ "area" ], "properties": { "area": { "$ref": "#/components/schemas/DamageArea" }, "side": { "type": "string", "enum": [ "nearside", "offside", "both" ], "default": "both", "description": "nearside (left), offside (right) or both. Parts that come in pairs only come off on that side." } } }, "DamageArea": { "type": "string", "enum": [ "powertrain", "front_end", "doors", "body", "interior", "wheels", "rear", "misc" ], "description": "powertrain: Engine, gearbox, turbo, alternator, starter motor, driveshafts, fuel pump, A/C compressor, exhaust and cat. front_end: Bonnet, front bumper, front wings, headlights, grille, radiator pack, slam panel and front subframe. doors: Doors, door glass, door cards, door mirrors, window regulators, locks and handles. body: Roof, sunroof, rear quarters, sills, fuel flap and parcel shelf. interior: Seats, dashboard, steering wheel, airbags, head unit or screen, instrument cluster, heater blower and controls. wheels: Alloy wheels, brakes and ABS pump, steering rack, suspension, hubs and wishbones. rear: Rear bumper, tailgate or boot lid, rear lights, rear wiper and tow bar. misc: Engine ECU, body control modules, wiper motors and sensors." }, "DemandTier": { "type": "string", "enum": [ "hot", "mid", "low" ], "description": "hot (score 8 to 10): Strong sales against the stock listed. Usually sells within weeks. mid (score 4 to 7): Steady sales against the stock listed. Usually sells within a few months. low (score 1 to 3): Weak sales against the stock listed. Can sit on the shelf." }, "Valuation": { "type": "object", "description": "A breaker value for one car. parts and removed are left out when detail is summary.", "required": [ "id", "object", "created", "reference", "vehicle", "value", "demand", "damage", "connect", "data" ], "properties": { "id": { "type": "string", "description": "Valuation ID. Fetch it again for 30 days." }, "object": { "type": "string", "const": "breaker_value" }, "created": { "type": "string", "format": "date-time", "description": "When the valuation ran (ISO 8601, UTC)." }, "reference": { "type": [ "string", "null" ], "maxLength": 64, "description": "Your reference, as sent." }, "vehicle": { "$ref": "#/components/schemas/Vehicle" }, "value": { "$ref": "#/components/schemas/ValueTotals" }, "demand": { "$ref": "#/components/schemas/CarDemand" }, "damage": { "$ref": "#/components/schemas/DamageSummary" }, "parts": { "type": "array", "description": "One line per part: name, area, qty, oem_numbers, lowest (a cautious low), average, sold_12m, active_listings and demand (score, tier, sells_in_days). Prices are per piece.", "items": { "$ref": "#/components/schemas/Part" } }, "removed": { "type": "array", "description": "Parts left out, with the reason (damage or below_min_part_value) and, when one side of a pair came off, the side.", "items": { "$ref": "#/components/schemas/RemovedPart" } }, "connect": { "$ref": "#/components/schemas/Connect" }, "data": { "$ref": "#/components/schemas/DataBasis" } } }, "Vehicle": { "type": "object", "description": "What the VIN or reg decoded to: vin, reg, make, model, generation, variant, year, first_registered, body, fuel, engine (size_cc, power_ps, code), transmission, drive and colour.", "required": [ "vin", "reg", "make", "model", "generation", "variant", "year", "first_registered", "body", "fuel", "engine", "transmission", "drive", "colour" ], "properties": { "vin": { "type": "string", "pattern": "^[A-HJ-NPR-Z0-9]{17}$" }, "reg": { "type": [ "string", "null" ], "description": "UK registration, when known." }, "make": { "type": "string" }, "model": { "type": "string" }, "generation": { "type": [ "string", "null" ] }, "variant": { "type": [ "string", "null" ] }, "year": { "type": "integer" }, "first_registered": { "type": [ "string", "null" ], "format": "date" }, "body": { "type": [ "string", "null" ] }, "fuel": { "type": [ "string", "null" ] }, "engine": { "type": "object", "required": [ "size_cc", "power_ps", "code" ], "properties": { "size_cc": { "type": [ "integer", "null" ] }, "power_ps": { "type": [ "integer", "null" ] }, "code": { "type": [ "string", "null" ], "description": "Engine code, when known." } } }, "transmission": { "type": [ "string", "null" ] }, "drive": { "type": [ "string", "null" ] }, "colour": { "type": [ "string", "null" ] } } }, "ValueTotals": { "type": "object", "description": "The breaker value of the car. Prices are per piece on parts, totals here.", "required": [ "currency", "vat", "lowest", "average", "parts", "pieces", "by_sell_time" ], "properties": { "currency": { "type": "string", "const": "GBP" }, "vat": { "type": "string", "enum": [ "inc", "ex" ], "description": "inc or ex, as requested." }, "lowest": { "type": "number", "minimum": 0, "description": "Breaker value at the cautious low end: the sum of qty × lowest for every part counted." }, "average": { "type": "number", "minimum": 0, "description": "Breaker value at the typical sold price: the sum of qty × average." }, "parts": { "type": "integer", "minimum": 0, "description": "Part lines counted." }, "pieces": { "type": "integer", "minimum": 0, "description": "Pieces counted. A pair of headlights is one line, two pieces." }, "by_sell_time": { "type": "array", "description": "The same totals for parts expected to sell within 90, 180 and 365 days. A part showing sells_in_days 365 is expected to take a year or more and is only in the full totals.", "items": { "type": "object", "required": [ "within_days", "parts", "lowest", "average" ], "properties": { "within_days": { "type": "integer", "enum": [ 90, 180, 365 ] }, "parts": { "type": "integer", "minimum": 0 }, "lowest": { "type": "number", "minimum": 0 }, "average": { "type": "number", "minimum": 0 } } } } } }, "CarDemand": { "type": "object", "description": "score (1 to 10) for the whole car, tier, and the value split into hot, mid and low tiers.", "required": [ "score", "tier", "by_tier" ], "properties": { "score": { "type": "number", "minimum": 1, "maximum": 10, "description": "Score for the whole car, with valuable parts counting for more." }, "tier": { "$ref": "#/components/schemas/DemandTier" }, "by_tier": { "type": "object", "required": [ "hot", "mid", "low" ], "properties": { "hot": { "type": "object", "description": "Part lines in the hot tier and what they add up to.", "required": [ "parts", "lowest", "average" ], "properties": { "parts": { "type": "integer", "minimum": 0 }, "lowest": { "type": "number", "minimum": 0 }, "average": { "type": "number", "minimum": 0 } } }, "mid": { "type": "object", "description": "Part lines in the mid tier and what they add up to.", "required": [ "parts", "lowest", "average" ], "properties": { "parts": { "type": "integer", "minimum": 0 }, "lowest": { "type": "number", "minimum": 0 }, "average": { "type": "number", "minimum": 0 } } }, "low": { "type": "object", "description": "Part lines in the low tier and what they add up to.", "required": [ "parts", "lowest", "average" ], "properties": { "parts": { "type": "integer", "minimum": 0 }, "lowest": { "type": "number", "minimum": 0 }, "average": { "type": "number", "minimum": 0 } } } } } } }, "DamageSummary": { "type": "object", "description": "The areas you sent, how many pieces came off and the value removed.", "required": [ "areas", "pieces_removed", "value_removed" ], "properties": { "areas": { "type": "array", "items": { "$ref": "#/components/schemas/DamageItem" } }, "pieces_removed": { "type": "integer", "minimum": 0 }, "value_removed": { "type": "object", "description": "What the parts taken off for damage were worth.", "required": [ "lowest", "average" ], "properties": { "lowest": { "type": "number", "minimum": 0, "description": "Sum of qty × lowest, in pounds." }, "average": { "type": "number", "minimum": 0, "description": "Sum of qty × average, in pounds." } } } } }, "Part": { "type": "object", "description": "One part line. lowest and average are per piece.", "required": [ "name", "area", "qty", "oem_numbers", "lowest", "average", "sold_12m", "active_listings", "demand" ], "properties": { "name": { "type": "string" }, "area": { "$ref": "#/components/schemas/DamageArea" }, "qty": { "type": "integer", "minimum": 1 }, "oem_numbers": { "type": "array", "items": { "type": "string" }, "description": "OEM part numbers matched for this part." }, "lowest": { "type": "number", "minimum": 0, "description": "A cautious low UK sold price per piece over the last 12 months." }, "average": { "type": "number", "minimum": 0, "description": "Average UK sold price per piece over the last 12 months." }, "sold_12m": { "type": "integer", "minimum": 0, "description": "How many sales of this part POXA recorded in the last 12 months (all sides for a pair)." }, "active_listings": { "type": "integer", "minimum": 0, "description": "How many are listed for sale, counted as of data.listings_as_of." }, "demand": { "$ref": "#/components/schemas/PartDemand" }, "yours": { "$ref": "#/components/schemas/PartYours" } } }, "PartDemand": { "type": "object", "required": [ "score", "tier", "sells_in_days" ], "properties": { "score": { "type": "integer", "minimum": 1, "maximum": 10 }, "tier": { "$ref": "#/components/schemas/DemandTier" }, "sells_in_days": { "type": [ "integer", "null" ], "minimum": 0, "maximum": 365, "description": "Estimated days to sell one at a typical price. Capped at 365, so 365 means a year or more and the part is not in the 365-day by_sell_time total. An estimate, not a promise." } } }, "PartYours": { "type": "object", "description": "Per part: in_stock, sold_12m and your_average. Planned: only when your yard system or online store is connected.", "required": [ "in_stock", "sold_12m", "your_average" ], "properties": { "in_stock": { "type": "integer", "minimum": 0 }, "sold_12m": { "type": "integer", "minimum": 0 }, "your_average": { "type": [ "number", "null" ], "minimum": 0 } } }, "RemovedPart": { "type": "object", "description": "A part left out of the value. lowest and average are per piece.", "required": [ "name", "area", "qty", "lowest", "average", "reason" ], "properties": { "name": { "type": "string" }, "area": { "$ref": "#/components/schemas/DamageArea" }, "side": { "type": "string", "enum": [ "nearside", "offside", "both" ], "description": "The side it came off, for parts that come in pairs." }, "qty": { "type": "integer", "minimum": 1 }, "lowest": { "type": "number", "minimum": 0 }, "average": { "type": "number", "minimum": 0 }, "reason": { "type": "string", "enum": [ "damage", "below_min_part_value" ] } } }, "Connect": { "type": "object", "description": "connected: false. The cross-reference with your own yard data is planned (see Your yard data).", "required": [ "connected" ], "properties": { "connected": { "type": "boolean", "description": "false today. Planned: true once your account has a yard system or online store connected." }, "systems": { "type": "array", "items": { "type": "string" }, "description": "What is connected: yard_system, online_store or both. Planned." }, "parts_in_stock": { "type": "integer", "minimum": 0, "description": "Part lines on this car you already hold in stock. Planned." }, "parts_sold_by_you_12m": { "type": "integer", "minimum": 0, "description": "Part lines on this car you have sold in the last 12 months. Planned." }, "revenue_overlap": { "type": "number", "minimum": 0, "maximum": 1, "description": "Share of the car’s average value in part lines you have sold in the last 12 months, from 0 to 1. Planned." }, "analytics_available": { "type": "boolean", "description": "Planned: true when this valuation will be compared with what the car makes once it is broken. Will need a connected yard system and your stock number in reference." } } }, "DataBasis": { "type": "object", "description": "basis (sold), the 12-month window of sold data used, listings_as_of (when the listing counts were last updated) and the source.", "required": [ "basis", "window", "source" ], "properties": { "basis": { "type": "string", "const": "sold" }, "window": { "type": "object", "description": "The 12-month window of sold data used.", "required": [ "from", "to" ], "properties": { "from": { "type": "string", "format": "date" }, "to": { "type": "string", "format": "date" } } }, "listings_as_of": { "type": "string", "format": "date", "description": "When the listing data behind active_listings was last updated." }, "source": { "type": "string" } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "$ref": "#/components/schemas/ErrorDetail" } } }, "ErrorDetail": { "type": "object", "required": [ "code", "message", "request_id" ], "properties": { "code": { "type": "string", "enum": [ "invalid_request", "unauthorised", "quota_exceeded", "vehicle_not_found", "not_found", "insufficient_data", "rate_limited", "server_error" ], "description": "invalid_request (400): Neither vin nor reg was sent, the VIN is not 17 characters, or a field has a value we do not accept. unauthorised (401): The API key is missing, wrong or revoked. quota_exceeded (402): Your plan has no valuations left this month. vehicle_not_found (404): We could not find a vehicle for that reg or VIN. not_found (404): No valuation or batch with that id, or it is more than 30 days old. insufficient_data (422): We found the car but there is not enough UK sold evidence to value it. You are not charged. rate_limited (429): Too many requests. Wait for the number of seconds in the Retry-After header. server_error (500): Something went wrong our end. Retry with backoff. You are not charged." }, "message": { "type": "string" }, "request_id": { "type": "string", "description": "Quote this if you contact us." } } }, "BatchRequest": { "type": "object", "description": "Up to 500 cars. Each car takes the same fields as a single valuation.", "required": [ "vehicles" ], "properties": { "vehicles": { "type": "array", "minItems": 1, "maxItems": 500, "items": { "$ref": "#/components/schemas/BatchVehicle" } }, "min_part_value": { "type": "number", "minimum": 0, "default": 40, "description": "Default for every car in the batch." }, "vat": { "type": "string", "enum": [ "inc", "ex" ], "default": "inc", "description": "Default for every car in the batch." }, "detail": { "type": "string", "enum": [ "full", "summary" ], "default": "summary", "description": "Batch results come back with detail summary unless you ask for full." }, "webhook_url": { "type": "string", "format": "uri", "description": "We post the finished batch here." } } }, "Batch": { "type": "object", "required": [ "id", "status", "vehicles" ], "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": [ "queued", "running", "complete" ] }, "vehicles": { "type": "integer", "minimum": 0, "description": "Cars in the batch." }, "results": { "type": "array", "description": "One entry per car, in the order sent, once the batch is complete.", "items": { "type": "object", "properties": { "reference": { "type": [ "string", "null" ] }, "valuation": { "$ref": "#/components/schemas/Valuation" }, "error": { "$ref": "#/components/schemas/ErrorDetail" } } } } } }, "BatchVehicle": { "type": "object", "description": "One car in a batch. The same fields as a single valuation; min_part_value, vat and detail default to the batch values.", "anyOf": [ { "required": [ "vin" ] }, { "required": [ "reg" ] } ], "properties": { "vin": { "type": "string", "description": "17-character VIN. Spaces are ignored. Letters I, O and Q are not used in VINs.", "examples": [ "WVWZZZAUZFW321566" ] }, "reg": { "type": "string", "description": "UK registration (number plate). Spaces are ignored. We look up the VIN for you.", "examples": [ "OW65DNU" ] }, "damage": { "type": "array", "description": "Areas of the car that are damaged. Parts in a listed area come off the value. See Damage.", "items": { "$ref": "#/components/schemas/DamageItem" } }, "min_part_value": { "type": "number", "minimum": 0, "description": "Leave out parts whose average sold price is under this many pounds. 0 counts every part with sales." }, "vat": { "type": "string", "enum": [ "inc", "ex" ], "description": "inc returns prices as buyers paid them. ex returns them with VAT removed (divided by 1.20)." }, "detail": { "type": "string", "enum": [ "full", "summary" ], "description": "full lists every part. summary leaves out parts and removed." }, "reference": { "type": "string", "maxLength": 64, "description": "Your stock or lot number, up to 64 characters. Returned as sent. Planned: with a connected yard system, your stock number will let us compare the valuation with what the car really makes." } } } }, "responses": { "InvalidRequest": { "description": "Neither vin nor reg was sent, the VIN is not 17 characters, or a field has a value we do not accept.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "invalid_request": { "value": { "error": { "code": "invalid_request", "message": "Neither vin nor reg was sent, the VIN is not 17 characters, or a field has a value we do not accept.", "request_id": "req_01example" } } } } } } }, "Unauthorised": { "description": "The API key is missing, wrong or revoked.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "unauthorised": { "value": { "error": { "code": "unauthorised", "message": "The API key is missing, wrong or revoked.", "request_id": "req_01example" } } } } } } }, "QuotaExceeded": { "description": "Your plan has no valuations left this month.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "quota_exceeded": { "value": { "error": { "code": "quota_exceeded", "message": "Your plan has no valuations left this month.", "request_id": "req_01example" } } } } } } }, "NotFound": { "description": "We could not find a vehicle for that reg or VIN.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "vehicle_not_found": { "value": { "error": { "code": "vehicle_not_found", "message": "We could not find a vehicle for that reg or VIN.", "request_id": "req_01example" } } } } } } }, "InsufficientData": { "description": "We found the car but there is not enough UK sold evidence to value it. You are not charged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "insufficient_data": { "value": { "error": { "code": "insufficient_data", "message": "We found this vehicle but there is not enough UK sold evidence to value it.", "request_id": "req_01example" } } } } } } }, "RateLimited": { "description": "Too many requests. Wait for the number of seconds in the Retry-After header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "rate_limited": { "value": { "error": { "code": "rate_limited", "message": "Too many requests. Wait for the number of seconds in the Retry-After header.", "request_id": "req_01example" } } } } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 0 } } } }, "ServerError": { "description": "Something went wrong our end. Retry with backoff. You are not charged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "server_error": { "value": { "error": { "code": "server_error", "message": "Something went wrong our end. Retry with backoff. You are not charged.", "request_id": "req_01example" } } } } } } } } } }