--- title: "Fluids for the vehicle a VIN decodes to." method: GET path: "/v1/vin/{vin}/fluids" tags: ["VIN"] --- # Fluids for the vehicle a VIN decodes to. `GET /v1/vin/{vin}/fluids` ## Request - Base URL: `https://open.wenmarpro.com` - URL: `https://open.wenmarpro.com/v1/vin/{vin}/fluids` - Auth: none declared When the decode settles the engine, `engine_oil` holds the one entry of that engine, or none, and each hand-read list holds the records of that engine and those recorded for every engine. Otherwise each holds every engine's. ## Path parameters - `vin` string, required ## Query parameters - `year` integer ## Response `200` The engine oil grades and the records read by hand. - VinFluids: The fluids for the vehicle a VIN decodes to. - `as_of` string, nullable - `attribution` string[], required - `brake` FluidRecord[], required - `applies_to` string, nullable: Which transmission or system the record is for, when it says. - `capacity_l` number, double, nullable - `capacity_qt` number, double, nullable: US liquid quarts. - `capacity_written_in` string, nullable: The unit the document printed, `l` or `qt`. The other figure was worked out from it. - `charge_g` integer, nullable: Refrigerant charge, in grams. - `charge_oz` number, double, nullable: Refrigerant charge, in ounces. - `charge_written_in` string, nullable: `g`, `kg`, `oz` or `lb`. - `checked` string, required: The day it was read. - `engine` EngineRef: A catalog engine of the model year. - `id` string, required: The engine's id form, as in a vehicle id. - `label` string, required - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine. - `grade` string, nullable: Engine oil viscosity, as the document gives it. - `market` string, nullable: `us` or `ca` when the document is for one country only. - `source` string, required: The document the record was read from. - `specification` string, nullable: The maker's specification, or the type of fluid. - `with_filter` boolean, nullable: Whether the capacity includes the oil filter. - `checked_as_of` string, nullable - `coolant` FluidRecord[], required - `applies_to` string, nullable: Which transmission or system the record is for, when it says. - `capacity_l` number, double, nullable - `capacity_qt` number, double, nullable: US liquid quarts. - `capacity_written_in` string, nullable: The unit the document printed, `l` or `qt`. The other figure was worked out from it. - `charge_g` integer, nullable: Refrigerant charge, in grams. - `charge_oz` number, double, nullable: Refrigerant charge, in ounces. - `charge_written_in` string, nullable: `g`, `kg`, `oz` or `lb`. - `checked` string, required: The day it was read. - `engine` EngineRef: A catalog engine of the model year. - `id` string, required: The engine's id form, as in a vehicle id. - `label` string, required - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine. - `grade` string, nullable: Engine oil viscosity, as the document gives it. - `market` string, nullable: `us` or `ca` when the document is for one country only. - `source` string, required: The document the record was read from. - `specification` string, nullable: The maker's specification, or the type of fluid. - `with_filter` boolean, nullable: Whether the capacity includes the oil filter. - `decode` RecallDecode, required: What a VIN decoded to, as far as recalls need it. - `make` string, nullable - `model` string, nullable - `trim` string, nullable - `valid` boolean, required: Whether the check digit is right. - `vin` string, required - `year` integer, nullable - `engine` EngineRef: A catalog engine of the model year. - `id` string, required: The engine's id form, as in a vehicle id. - `label` string, required - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine. - `engine_oil` EngineOil[], required - `as_written` string[], required: The maker's own spellings the grades were read from. - `confidence` string, required: `engine` when the grade is for one catalog engine; `model` when only the model year is known, and then `engine` is null. - `cylinders` integer, nullable - `displacement_l` number, double, nullable - `engine` EngineRef: A catalog engine of the model year. - `id` string, required: The engine's id form, as in a vehicle id. - `label` string, required - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine. - `grades` string[], required: Standard grades. More than one when the maker listed more than one. - `source` string, required: Always `EPA fuel economy certification`: the grade the maker certified with, not a reading of the owner's manual. - `engine_oil_checked` FluidRecord[], required: Narrowed as `engine_oil` is. A record for every engine is kept. - `applies_to` string, nullable: Which transmission or system the record is for, when it says. - `capacity_l` number, double, nullable - `capacity_qt` number, double, nullable: US liquid quarts. - `capacity_written_in` string, nullable: The unit the document printed, `l` or `qt`. The other figure was worked out from it. - `charge_g` integer, nullable: Refrigerant charge, in grams. - `charge_oz` number, double, nullable: Refrigerant charge, in ounces. - `charge_written_in` string, nullable: `g`, `kg`, `oz` or `lb`. - `checked` string, required: The day it was read. - `engine` EngineRef: A catalog engine of the model year. - `id` string, required: The engine's id form, as in a vehicle id. - `label` string, required - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine. - `grade` string, nullable: Engine oil viscosity, as the document gives it. - `market` string, nullable: `us` or `ca` when the document is for one country only. - `source` string, required: The document the record was read from. - `specification` string, nullable: The maker's specification, or the type of fluid. - `with_filter` boolean, nullable: Whether the capacity includes the oil filter. - `engine_settled` boolean, required: Whether `engine_oil` is narrowed to `engine`. - `refrigerant` FluidRecord[], required - `applies_to` string, nullable: Which transmission or system the record is for, when it says. - `capacity_l` number, double, nullable - `capacity_qt` number, double, nullable: US liquid quarts. - `capacity_written_in` string, nullable: The unit the document printed, `l` or `qt`. The other figure was worked out from it. - `charge_g` integer, nullable: Refrigerant charge, in grams. - `charge_oz` number, double, nullable: Refrigerant charge, in ounces. - `charge_written_in` string, nullable: `g`, `kg`, `oz` or `lb`. - `checked` string, required: The day it was read. - `engine` EngineRef: A catalog engine of the model year. - `id` string, required: The engine's id form, as in a vehicle id. - `label` string, required - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine. - `grade` string, nullable: Engine oil viscosity, as the document gives it. - `market` string, nullable: `us` or `ca` when the document is for one country only. - `source` string, required: The document the record was read from. - `specification` string, nullable: The maker's specification, or the type of fluid. - `with_filter` boolean, nullable: Whether the capacity includes the oil filter. - `transmission` FluidRecord[], required - `applies_to` string, nullable: Which transmission or system the record is for, when it says. - `capacity_l` number, double, nullable - `capacity_qt` number, double, nullable: US liquid quarts. - `capacity_written_in` string, nullable: The unit the document printed, `l` or `qt`. The other figure was worked out from it. - `charge_g` integer, nullable: Refrigerant charge, in grams. - `charge_oz` number, double, nullable: Refrigerant charge, in ounces. - `charge_written_in` string, nullable: `g`, `kg`, `oz` or `lb`. - `checked` string, required: The day it was read. - `engine` EngineRef: A catalog engine of the model year. - `id` string, required: The engine's id form, as in a vehicle id. - `label` string, required - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine. - `grade` string, nullable: Engine oil viscosity, as the document gives it. - `market` string, nullable: `us` or `ca` when the document is for one country only. - `source` string, required: The document the record was read from. - `specification` string, nullable: The maker's specification, or the type of fluid. - `with_filter` boolean, nullable: Whether the capacity includes the oil filter. - `vehicle` RecallVehicle: The model year an answer is about. - `id` string, required: The id of the year, make and model. - `make` string, required - `model` string, required - `year` integer, required - `warnings` Warning[], required - `code` string, required: `invalid_check_digit`, `model_year_unknown`, `no_patterns` or `model_unresolved`. More may be added. - `message` string, required - `suggestions` string[]: VINs the caller may have meant. ## Other responses - `400`: `invalid_vin`, or `validation_failed` for `year`. - `404`: `not_found`: no manufacturer is registered for the first three characters. `dataset_unavailable`: this server holds neither oil grades nor hand-read fluids. --- [API](https://skmtc.dev/wenmarpro/apis/wenmar-open.md) · [All operations](https://skmtc.dev/wenmarpro/apis/wenmar-open/llms.txt) · [OpenAPI document](https://skmtc.dev/wenmarpro/apis/wenmar-open/revisions/1027b548b6f0?raw)