Vincario VIN Decoder
Analytics & DataConnect AI agents to Vincario, a VIN decoding and vehicle data service. Agents turn a 17-character VIN into structured vehicle data, estimate market value, and run a stolen-vehicle check.
What This Integration Enables
A Vehicle Identification Number is the rare identifier that is both globally standardized and free at the point of use. Anyone holding the vehicle can read it, which is why rental, leasing, insurance, dealership, auction, and telematics operations all end up building the same thing: a way to turn 17 characters into everything else they need to know. Vincario is a connector for teams who have decided to stop asking customers to type what the VIN already contains.
The decoding path has two shapes for the same request. Decode VIN returns the vendor's response unchanged, a decode array where each entry carries a label, a value, and, for attributes backed by a reference list, the numeric id of that list entry. Decode VIN To Fields returns the same lookup flattened into an object keyed by attribute label, which is usually what a flow wants because a step can reference a value directly instead of searching an array. Coverage runs past 100 attributes for well covered vehicles: make, model, model year, body, engine, transmission, dimensions, weights, brakes, suspension, emissions, and electric vehicle data. OEM VIN Lookup goes further and queries the manufacturer's own database for things a VIN does not encode at all, including factory fitted equipment, exterior and interior color codes, German KBA type approval numbers, battery capacity and charging plug type, and the vehicle's original list price as configured.
Around that sit the actions that make a batch job survivable. Validate VIN issues no HTTP request at all. It checks the 17 character length, rejects the letters I, O and Q that the standard excludes because they are ambiguous with 1 and 0, and computes the ISO 3779 check digit for position 9. Worth knowing before you branch on it: that check digit is mandatory for vehicles built for the North American market and frequently absent elsewhere, so checkDigitValid is reported separately from valid and a false value alone is not proof the VIN is wrong. Get Balance returns the prepaid lookups remaining per service and consumes nothing, which is what a nightly job should gate on. Nine reference list actions return the catalogs behind the decoded ids so a Body ID or a Fuel Type ID can be resolved to a readable name without a second billed call. Vincario returns each catalog whole with no server side filtering, so the search and limit parameters on those actions are applied by FlowRunner after the response arrives.
Two operational facts shape every flow built here. Lookups are prepaid and consumed per call, tracked separately per service, and Decode VIN and Decode VIN To Fields are the same underlying request, so calling both on one VIN spends two credits. The same is true of Check Stolen Status and Get Stolen Check Summary. And Vincario answers every failure with HTTP status 200 and a JSON error body, including an exhausted balance, an unrecognized VIN, and the rate limit. A naive integration reads all of those as success. This connector inspects the body and raises the error instead, which is exactly the kind of thing a connector is supposed to absorb so a flow author never has to think about it.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Intake that fills itself in
A vehicle is entered into a rental or leasing intake sheet in Google Sheets with nothing but a scanned VIN and a customer name. A scheduled flow reads new rows, runs Validate VIN on each one locally so a typo never consumes credit, and calls Decode VIN To Fields on the survivors. The flat fields object populates make, model, model year, body, fuel type, transmission, and dimensions directly onto the record in HubSpot, and the ids object preserves the reference list ids so the same vehicle can be matched against inventory later without string comparison. Where the account has OEM VIN Lookup enabled and the vehicle is in an allowed market, a second call adds factory equipment and color codes to the record for the condition report. The customer typed 17 characters. The record holds several dozen fields, all of them standardized.
Cleaning a fleet database that grew by hand
An existing inventory table holds years of free-text entries where the same model appears as three spellings and half the body types are blank. A batch flow calls Get Vehicle Make And Model List, Get Body Types, Get Fuel Types, Get Drive Types, and Get Transmission Types once at the start and holds the catalogs in memory, then walks the table decoding each stored VIN. It replaces free-text make and model with the standardized names and stores the reference ids alongside them, so subsequent joins run on integers rather than on whoever typed the row. Get Balance is checked between passes and the job pauses with an alert to Slack before the account runs dry rather than after. Vincario enforces 60 requests per minute per account, so the pass paces itself under that, counting a decode and a stolen check on one vehicle as two requests.
Pricing a buyback against the actual market
A buyback, residual value, or insurance settlement needs a number, and the number has to be defensible. The agent calls Get Vehicle Market Value with the VIN and the recorded odometer reading. Vincario returns price and odometer statistics per continent, each with the count of observations, a lower bound, the median, the average, an upper bound, and the standard deviation, plus the exact period the statistics cover and a sample of the individual market records behind them. Supplying the odometer adds a price_odometer_adjusted block corrected for that mileage. Vincario returns a result only when at least 10 comparable vehicles were found and does not charge the request when it cannot, so the flow has to handle the insufficient data case as a normal outcome rather than an error, routing those vehicles to an appraiser instead of guessing. The valuation that reaches the customer carries the observation count and the period it covers, which is what makes it arguable rather than merely asserted.
Human-in-Loop Highlight
Get Stolen Check Summary runs the stolen vehicle check and reduces the per database results to something a flow can branch on: stolen as true when any connected database reports the VIN, the country codes that reported it, the databases that could not be reached, and the ones that reported the vehicle clean. It also returns a complete flag, and that flag is the reason this action needs a person rather than a threshold. Complete is true only when every connected database answered. When a police database fails to respond, Vincario reports could-not-verify for that country and complete comes back false, which means the clean result is provisional. A flow that branches on stolen being false alone will treat a provisional clean exactly like a verified one, and the difference between them is a trade-in payout, a title transfer, or a rental handover on a vehicle nobody has actually cleared. That is a decision with money and liability on the other side of it and no undo, and it is not a decision an agent should make on partial evidence. So the agent does everything that is mechanical. It decodes the vehicle, runs the check, and when complete comes back false it stops and posts to the intake owner: "VIN WVWZZZ1JZXW000001, 2019 model, trade-in appraisal 8841. Four databases report not-stolen. Czech Republic and Slovakia did not respond. This is a provisional clean. Hold the deal and retry the check, or proceed?" The person holds it, retries it, or accepts it with their name on the record, and the flow continues from there. Handling it as an automation exception rather than a silent pass is what makes the other 95 percent of vehicles safe to clear without anyone looking, which is the whole point of putting a human-in-the-loop gate on the narrow case instead of reviewing every one.
Agent Capabilities
18 actionsVIN Decoding
5- Validate VIN Checks a VIN entirely inside FlowRunner, issuing no HTTP request and consuming no lookup. Confirms the VIN is exactly 17 characters, contains no I, O or Q, and uses only digits and permitted letters, and computes the ISO 3779 check digit for position 9. The check digit is mandatory only for vehicles built for the North American market, so checkDigitValid is reported separately from valid. Use it to filter malformed input before any billed call.
- Get Available VIN Variables Returns the list of variable labels Decode VIN will be able to return for one specific VIN, without any values. Vincario documents this request as free, so it is the way to find out how much detail exists for a vehicle before spending a decode. Coverage varies widely, so two VINs from the same make can return very different label sets.
- Decode VIN Decodes a VIN into a full vehicle specification and returns the Vincario response unchanged, as a decode array of label, value, and reference list id entries, alongside the request price, currency, and the remaining balance per lookup type. Consumes one API Decode lookup.
- Decode VIN To Fields Decodes a VIN and returns the result as a flat object keyed by attribute label, plus an ids object mapping each label with a reference list id. The original decode array, price, currency, and balance come back alongside it. Same underlying request as Decode VIN and consumes one API Decode lookup, so do not call both on the same VIN.
- OEM VIN Lookup Queries the manufacturer's own database and returns what it holds beyond what the VIN encodes: factory fitted equipment, exterior and interior color codes, German KBA type approval numbers, battery capacity and charging plug type, and the original configured list price. Restricted by market, so a vehicle outside the markets enabled on the account is rejected with a message naming the market it belongs to. Consumes one API OEM VIN Lookup.
Vehicle Market Value
1- Get Vehicle Market Value Returns a vehicle's market value from the last 365 days of listing data, with price and odometer statistics per continent including observation count, lower bound, median, average, upper bound, and standard deviation, plus the exact period covered and a sample of the underlying market records. Supplying an odometer reading adds a price_odometer_adjusted block. Vincario returns a result only when at least 10 comparable vehicles were found and does not charge the request when it cannot. Consumes one API Vehicle Market Value lookup.
Stolen Check
2- Check Stolen Status Checks a VIN against the stolen vehicle databases Vincario is connected to and returns the raw per database result, one entry per database with a country code and a status. Documented statuses are stolen, not-stolen, and could-not-verify, where could-not-verify means that database failed to respond and the check should be retried. Consumes one API Stolen Check lookup.
- Get Stolen Check Summary Runs the same check and reduces it to a single decision: stolen true when any database reports the VIN, plus the lists of databases that reported it, could not be reached, and reported it clean. The complete flag is true only when every database answered, so a false value means the clean result is provisional. Consumes one API Stolen Check lookup, exactly like Check Stolen Status.
Account
1- Get Balance Returns the prepaid lookups remaining for each Vincario service as an object keyed by lookup type, covering API Decode, API Stolen Check, API Vehicle Market Value, API OEM VIN Lookup, and API OCR VIN Scanner on accounts that have it. Consumes no lookup, so gate a batch job on it rather than discovering the limit mid-run.
Reference Data
9- Get Vehicle Makes Returns the manufacturers Vincario recognizes, each with the numeric id used in decode results and the manufacturer name, covering global automotive brands as well as specialist producers of trucks, buses, motorcycles, tractors, trailers, and machinery. Vincario returns the whole catalog with no server side filtering, so search and limit are applied by FlowRunner after the response arrives.
- Get Vehicle Models Returns the model names Vincario recognizes, each with its numeric id. The list is global and not grouped by manufacturer, so it holds both standardized model names and manufacturer specific designations. Use Get Vehicle Make And Model List when the pairing matters.
- Get Vehicle Make And Model List Returns every make and model combination, each entry carrying the vehicle_id that Decode VIN reports as Vehicle ID together with the make and model names and their ids. This is the list for resolving a decoded Vehicle ID back to a readable make and model, or for building a picker.
- Get Body Types Returns the body types Vincario recognizes with the numeric id reported as Body ID in decode results, spanning passenger car bodies such as hatchback, coupe and convertible as well as buses, campers, jet skis, low speed vehicles, and motorcycle body styles.
- Get Colors Returns the standardized colors with the numeric id reported as Color ID in decode and OEM lookup results. Manufacturer specific paint names are reported separately in the decode result, so this list is the vocabulary those names map onto.
- Get Drive Types Returns the drivetrain configurations with the numeric id reported as Drive ID, covering front wheel drive, rear wheel drive, all wheel drive, four wheel drive, and none, plus the non standardized value.
- Get Fuel Types Returns the fuel types with the numeric ids reported as Fuel Type - Primary ID and Fuel Type - Secondary ID, covering gasoline and diesel as well as electric, hydrogen, compressed and liquefied natural gas, ethanol, and flexible fuel vehicles.
- Get Product Types Returns the highest level vehicle classification with the numeric id reported as Product Type, covering cars, buses, motorcycles, quads, snowmobiles, tractors, trailers, trucks, chassis, streetcars, jet skis, and special purpose vehicles.
- Get Transmission Types Returns the transmission types with the numeric id reported as Transmission ID in decode and market value results, covering manual and automatic as well as automated manual, continuously variable, dual clutch, electronic continuously variable, and the motorcycle drive types.
Frequently Asked Questions
What can FlowRunner do with Vincario VIN Decoder?
FlowRunner agents can run Validate VIN, Get Available VIN Variables, and Decode VIN in Vincario VIN Decoder, plus 15 more actions.
Does connecting Vincario VIN Decoder to FlowRunner require OAuth?
Vincario VIN Decoder uses a custom authentication method to connect to FlowRunner.
Can Vincario VIN Decoder trigger a FlowRunner workflow automatically?
Vincario VIN Decoder doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Vincario VIN Decoder
$100 in credits. No card required. Connect in minutes.