{"openapi":"3.1.0","info":{"title":"Standard Issue Data API","version":"1.0.0"},"servers":[{"url":"https://standardissuedata.com"}],"paths":{"/v1/vehicles/vin/{vin}":{"get":{"operationId":"lookupVin","summary":"Look up a vehicle by VIN","parameters":[{"name":"vin","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-HJ-NPR-Z0-9]{17}$"}}],"responses":{"200":{"description":"A VIN lookup with a separate outcome for each source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VinLookup"}}}},"400":{"description":"Invalid VIN."},"429":{"description":"Lookup capacity exceeded. Retry after the interval in the Retry-After header."},"503":{"description":"Lookup temporarily unavailable."}}}}},"components":{"schemas":{"VinLookup":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","const":"1"},"vin":{"type":"string","pattern":"^[A-HJ-NPR-Z0-9]{17}$"},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"identity":{"type":"object","properties":{"status":{"type":"string","enum":["decoded","partial","unavailable"]},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"scope":{"type":"string","const":"vin_pattern"},"north_american_check_digit_valid":{"type":"boolean"},"vehicle":{"anyOf":[{"type":"object","properties":{"year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"make":{"anyOf":[{"type":"string"},{"type":"null"}]},"model":{"anyOf":[{"type":"string"},{"type":"null"}]},"trim":{"anyOf":[{"type":"string"},{"type":"null"}]},"series":{"anyOf":[{"type":"string"},{"type":"null"}]},"body_class":{"anyOf":[{"type":"string"},{"type":"null"}]},"engine":{"type":"object","properties":{"cylinders":{"anyOf":[{"type":"number"},{"type":"null"}]},"displacement_l":{"anyOf":[{"type":"number"},{"type":"null"}]},"fuel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["cylinders","displacement_l","fuel"],"additionalProperties":false},"drive_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"transmission":{"anyOf":[{"type":"string"},{"type":"null"}]},"manufacturer":{"anyOf":[{"type":"string"},{"type":"null"}]},"plant_country":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["year","make","model","trim","series","body_class","engine","drive_type","transmission","manufacturer","plant_country"],"additionalProperties":false},{"type":"null"}]}},"required":["status","source","scope","north_american_check_digit_valid","vehicle"],"additionalProperties":false},"recalls":{"type":"object","properties":{"status":{"type":"string","enum":["found","no_records","missing_identity","unsupported","unavailable"]},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"scope":{"type":"string","const":"year_make_model"},"vin_open_recall_check_url":{"type":"string","format":"uri"},"match_basis":{"anyOf":[{"type":"string"},{"type":"null"}]},"matched_models":{"type":"array","items":{"type":"string"}},"candidate_models":{"type":"array","items":{"type":"string"}},"campaigns":{"type":"array","items":{"type":"object","properties":{"campaign_number":{"type":"string"},"report_received_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"component":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"consequence":{"anyOf":[{"type":"string"},{"type":"null"}]},"remedy":{"anyOf":[{"type":"string"},{"type":"null"}]},"park_it":{"type":"boolean"},"park_outside":{"type":"boolean"},"over_the_air_update":{"type":"boolean"},"recall_model":{"type":"string"}},"required":["campaign_number","report_received_date","component","summary","consequence","remedy","park_it","park_outside","over_the_air_update","recall_model"],"additionalProperties":false}}},"required":["status","source","scope","vin_open_recall_check_url","match_basis","matched_models","candidate_models","campaigns"],"additionalProperties":false},"complaints":{"type":"object","properties":{"status":{"type":"string","enum":["found","no_records","missing_identity","unsupported","unavailable"]},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"scope":{"type":"string","const":"year_make_model"},"queried_model":{"anyOf":[{"type":"string"},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"reports":{"maxItems":12,"type":"array","items":{"type":"object","properties":{"odi_number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"filed_on":{"type":"string"},"incident_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"components":{"type":"string"},"reported_summary":{"type":"string"}},"required":["odi_number","filed_on","incident_on","components","reported_summary"],"additionalProperties":false}}},"required":["status","source","scope","queried_model","total","reports"],"additionalProperties":false},"fuel_economy":{"type":"object","properties":{"status":{"type":"string","enum":["found","no_records","missing_identity","unsupported","unavailable"]},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"scope":{"type":"string","const":"configuration"},"match_basis":{"anyOf":[{"type":"string"},{"type":"null"}]},"matched_models":{"type":"array","items":{"type":"string"}},"candidate_models":{"type":"array","items":{"type":"string"}},"narrowed_by":{"type":"array","items":{"type":"string"}},"configurations":{"maxItems":12,"type":"array","items":{"type":"object","properties":{"epa_id":{"type":"string"},"epa_model":{"type":"string"},"transmission":{"anyOf":[{"type":"string"},{"type":"null"}]},"drive":{"anyOf":[{"type":"string"},{"type":"null"}]},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"unit":{"type":"string","enum":["mpg","mpge"]},"city":{"anyOf":[{"type":"number"},{"type":"null"}]},"highway":{"anyOf":[{"type":"number"},{"type":"null"}]},"combined":{"anyOf":[{"type":"number"},{"type":"null"}]},"second_fuel":{"anyOf":[{"type":"object","properties":{"fuel_type":{"type":"string"},"unit":{"type":"string","enum":["mpg","mpge"]},"city":{"anyOf":[{"type":"number"},{"type":"null"}]},"highway":{"anyOf":[{"type":"number"},{"type":"null"}]},"combined":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["fuel_type","unit","city","highway","combined"],"additionalProperties":false},{"type":"null"}]},"electric_range_miles":{"anyOf":[{"type":"number"},{"type":"null"}]},"annual_fuel_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"co2_tailpipe_g_per_mile":{"anyOf":[{"type":"number"},{"type":"null"}]},"greenhouse_gas_score":{"anyOf":[{"type":"number"},{"type":"null"}]},"gas_guzzler_tax":{"type":"boolean"},"vehicle_class":{"anyOf":[{"type":"string"},{"type":"null"}]},"engine":{"type":"object","properties":{"cylinders":{"anyOf":[{"type":"number"},{"type":"null"}]},"displacement_l":{"anyOf":[{"type":"number"},{"type":"null"}]},"turbocharged":{"type":"boolean"},"supercharged":{"type":"boolean"}},"required":["cylinders","displacement_l","turbocharged","supercharged"],"additionalProperties":false}},"required":["epa_id","epa_model","transmission","drive","fuel_type","unit","city","highway","combined","second_fuel","electric_range_miles","annual_fuel_cost_usd","co2_tailpipe_g_per_mile","greenhouse_gas_score","gas_guzzler_tax","vehicle_class","engine"],"additionalProperties":false}}},"required":["status","source","scope","match_basis","matched_models","candidate_models","narrowed_by","configurations"],"additionalProperties":false},"listing_history":{"type":"object","properties":{"status":{"type":"string","enum":["found","no_records","missing_identity","unsupported","unavailable"]},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"scope":{"type":"string","const":"exact_vin"},"complete":{"type":"boolean","const":false},"retrieved_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"appearances":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"source_label":{"type":"string"},"source_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"record":{"type":"string","enum":["current","historical"]},"lifecycle_projection":{"anyOf":[{"type":"string"},{"type":"null"}]},"mileage":{"anyOf":[{"type":"string"},{"type":"null"}]},"price_change_events":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"money":{"type":"object","properties":{"asking_price_minor":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"current_bid_minor":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"stored_currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency_verification":{"type":"string","const":"not_established_by_this_response"}},"required":["asking_price_minor","current_bid_minor","stored_currency","currency_verification"],"additionalProperties":false},"times":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_seen_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["captured_at","last_seen_at"],"additionalProperties":false}},"required":["title","source_label","source_url","record","lifecycle_projection","mileage","price_change_events","money","times"],"additionalProperties":false}}},"required":["status","source","scope","complete","retrieved_at","appearances"],"additionalProperties":false},"history_reports":{"type":"object","properties":{"carfax":{"type":"object","properties":{"status":{"type":"string","enum":["seller_link","unchecked"]},"url":{"type":"string","format":"uri"},"evidence_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["status","url","evidence_url"],"additionalProperties":false},"autocheck":{"type":"object","properties":{"status":{"type":"string","enum":["seller_link","unchecked"]},"url":{"type":"string","format":"uri"},"evidence_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["status","url","evidence_url"],"additionalProperties":false}},"required":["carfax","autocheck"],"additionalProperties":false}},"required":["version","vin","retrieved_at","identity","recalls","complaints","fuel_economy","listing_history","history_reports"],"additionalProperties":false}}}}