/nhtsa/vins/batch

POST /api/nhtsa/vins/batch

Price: 10 credits

Decode up to 50 VINs in one call with the NHTSA vPIC decoder.

How to use it

Use it instead of calling nhtsa/vins in a loop when you hold a list of VINs. Rows keep the input order; a VIN that decodes to no make, model or vehicle type is left out, so match rows back by `vin`. `error_code` 0 means a clean decode.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• vins array required — VINs to decode in one call: full 17-character VINs, or partial with * in unknown positions (examples: ["1HGCM82633A004352","JH4KA7561PC008269"]; minItems: 1; maxItems: 50)
• model_year integer nullable — Model year applied to every VIN, which helps decode partial and pre-1980 VINs (examples: 2003; min: 1900; max: 2100)

Response

• @type string (default: "NhtsaVin")
• vin string required
• model_year integer nullable
• abs string nullable
• active_safety_sys_note string nullable
• adaptive_cruise_control string nullable
• adaptive_driving_beam string nullable
• adaptive_headlights string nullable
• additional_error_text string nullable
• air_bag_loc_curtain string nullable
• air_bag_loc_front string nullable
• air_bag_loc_knee string nullable
• air_bag_loc_seat_cushion string nullable
• air_bag_loc_side string nullable
• auto_reverse_system string nullable
• automatic_pedestrian_alerting_sound string nullable
• axle_configuration string nullable
• axles string nullable
• base_price string nullable
• battery_a string nullable
• battery_a_to string nullable
• battery_cells string nullable
• battery_info string nullable
• battery_kwh string nullable
• battery_kwh_to string nullable
• battery_modules string nullable
• battery_packs string nullable
• battery_type string nullable
• battery_v string nullable
• battery_v_to string nullable
• bed_length_in string nullable
• bed_type string nullable
• blind_spot_intervention string nullable
• blind_spot_mon string nullable
• body_cab_type string nullable
• body_class string nullable
• brake_system_desc string nullable
• brake_system_type string nullable
• bus_floor_config_type string nullable
• bus_length string nullable
• bus_type string nullable
• can_aacn string nullable
• cib string nullable
• cash_for_clunkers string nullable
• charger_level string nullable
• charger_power_kw string nullable
• combined_braking_system string nullable
• cooling_type string nullable
• curb_weight_lb string nullable
• custom_motorcycle_type string nullable
• daytime_running_light string nullable
• destination_market string nullable
• displacement_cc string nullable
• displacement_ci string nullable
• displacement_l string nullable
• doors string nullable
• drive_type string nullable
• driver_assist string nullable
• dynamic_brake_support string nullable
• edr string nullable
• esc string nullable
• ev_drive_unit string nullable
• electrification_level string nullable
• engine_configuration string nullable
• engine_cycles string nullable
• engine_cylinders string nullable
• engine_hp string nullable
• engine_hp_to string nullable
• engine_kw string nullable
• engine_manufacturer string nullable
• engine_model string nullable
• entertainment_system string nullable
• error_code string nullable
• error_text string nullable
• forward_collision_warning string nullable
• fuel_injection_type string nullable
• fuel_tank_material string nullable
• fuel_tank_type string nullable
• fuel_type_primary string nullable
• fuel_type_secondary string nullable
• gcwr string nullable
• gcwr_to string nullable
• gvwr string nullable
• gvwr_to string nullable
• keyless_ignition string nullable
• lane_centering_assistance string nullable
• lane_departure_warning string nullable
• lane_keep_system string nullable
• lower_beam_headlamp_light_source string nullable
• make string nullable
• make_id string nullable
• manufacturer string nullable
• manufacturer_id string nullable
• model string nullable
• model_id string nullable
• motorcycle_chassis_type string nullable
• motorcycle_suspension_type string nullable
• ncsa_body_type string nullable
• ncsa_make string nullable
• ncsa_map_exc_approved_by string nullable
• ncsa_map_exc_approved_on string nullable
• ncsa_mapping_exception string nullable
• ncsa_model string nullable
• ncsa_note string nullable
• non_land_use string nullable
• note string nullable
• other_bus_info string nullable
• other_engine_info string nullable
• other_motorcycle_info string nullable
• other_restraint_system_info string nullable
• other_trailer_info string nullable
• park_assist string nullable
• pedestrian_automatic_emergency_braking string nullable
• plant_city string nullable
• plant_company_name string nullable
• plant_country string nullable
• plant_state string nullable
• possible_values string nullable
• pretensioner string nullable
• rear_automatic_emergency_braking string nullable
• rear_cross_traffic_alert string nullable
• rear_visibility_system string nullable
• sae_automation_level string nullable
• sae_automation_level_to string nullable
• seat_belts_all string nullable
• seat_rows string nullable
• seats string nullable
• semiautomatic_headlamp_beam_switching string nullable
• series string nullable
• series2 string nullable
• steering_location string nullable
• suggested_vin string nullable
• tpms string nullable
• top_speed_mph string nullable
• track_width string nullable
• traction_control string nullable
• trailer_body_type string nullable
• trailer_length string nullable
• trailer_type string nullable
• transmission_speeds string nullable
• transmission_style string nullable
• trim string nullable
• trim2 string nullable
• turbo string nullable
• valve_train_design string nullable
• vehicle_descriptor string nullable
• vehicle_type string nullable
• wheel_base_long string nullable
• wheel_base_short string nullable
• wheel_base_type string nullable
• wheel_size_front string nullable
• wheel_size_rear string nullable
• wheelie_mitigation string nullable
• wheels string nullable
• windows string nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.