{ "openapi": "3.1.0", "info": { "title": "Recallroll API", "version": "1.0.0", "summary": "VIN decoder API and vehicle recall check API: decode up to 10 VINs per call (year, make, model, trim, engine, plant) and get every NHTSA safety recall with Do Not Drive / Park Outside advisories, remedy and campaign links. REST + MCP server.", "description": "Send up to 10 VINs per call and get each vehicle decoded plus every NHTSA safety recall for it, with Do Not Drive and Park Outside warnings first. For dealers, fleets, lenders, insurers and apps. Free tier, no key; plans from $19/month.\n\nFree tier: Up to 10 VINs per call; 10 calls a minute per IP on the free tier. Free tier: 50 calls a day per IP, no key. Paid keys from $19/month (see Get an API key). Recalls are listed per make, model and model year, as NHTSA publishes them; confirm a specific VIN at nhtsa.gov/recalls. Nothing is stored: each call asks NHTSA live (cached up to 10 minutes). No key needed. Remote MCP server: https://recallroll-api.cybermax-tools.workers.dev/mcp\n\nPricing: free tier 50 calls/day per IP, no key. Paid API keys: Shop $19/month = 2,000 calls/month; Dealer $49/month = 7,500 calls/month; Fleet $99/month = 20,000 calls/month; Pay as you go $5 = 400 calls (one-time pack); Shop yearly $190/year = 2,000 calls/month; Dealer yearly $490/year = 7,500 calls/month; Fleet yearly $990/year = 20,000 calls/month. Get a key: https://recallroll-api.cybermax-tools.workers.dev/docs#pricing", "contact": { "name": "CyberMax", "url": "https://cybermax-tools-cybermax.static.hf.space/" }, "license": { "name": "Proprietary (free tier + paid API keys)", "identifier": "LicenseRef-CyberMax" }, "x-pricing": { "api": "Recallroll API", "currency": "USD", "free": { "price": 0, "callsPerDayPerIp": 50, "perMinutePerIp": 10, "key": "none needed" }, "plans": [ { "id": "shop", "name": "Shop", "price": 19, "billing": "per month", "calls": 2000, "per": "calendar month (UTC)", "perMinute": 30, "buy": "https://recallroll-api.cybermax-tools.workers.dev/buy/shop?s=openapi" }, { "id": "dealer", "name": "Dealer", "price": 49, "billing": "per month", "calls": 7500, "per": "calendar month (UTC)", "perMinute": 60, "buy": "https://recallroll-api.cybermax-tools.workers.dev/buy/dealer?s=openapi" }, { "id": "fleet", "name": "Fleet", "price": 99, "billing": "per month", "calls": 20000, "per": "calendar month (UTC)", "perMinute": 120, "buy": "https://recallroll-api.cybermax-tools.workers.dev/buy/fleet?s=openapi" }, { "id": "payg", "name": "Pay as you go", "price": 5, "billing": "one-time", "calls": 400, "per": "until used", "perMinute": 30, "buy": "https://recallroll-api.cybermax-tools.workers.dev/buy/payg?s=openapi" }, { "id": "shop-yearly", "name": "Shop yearly", "price": 190, "billing": "per year", "calls": 2000, "per": "calendar month (UTC)", "perMinute": 30, "buy": "https://recallroll-api.cybermax-tools.workers.dev/buy/shop-yearly?s=openapi" }, { "id": "dealer-yearly", "name": "Dealer yearly", "price": 490, "billing": "per year", "calls": 7500, "per": "calendar month (UTC)", "perMinute": 60, "buy": "https://recallroll-api.cybermax-tools.workers.dev/buy/dealer-yearly?s=openapi" }, { "id": "fleet-yearly", "name": "Fleet yearly", "price": 990, "billing": "per year", "calls": 20000, "per": "calendar month (UTC)", "perMinute": 120, "buy": "https://recallroll-api.cybermax-tools.workers.dev/buy/fleet-yearly?s=openapi" } ], "unit": "calls", "howToUse": { "header": "x-api-key: YOUR_KEY", "alt": [ "Authorization: Bearer YOUR_KEY", "?key=YOUR_KEY" ], "mcp": "send the key as Authorization: Bearer YOUR_KEY", "usage": "https://recallroll-api.cybermax-tools.workers.dev/key" }, "manageKey": "https://recallroll-api.cybermax-tools.workers.dev/manage", "allAccess": { "name": "CyberMax API All-Access", "apis": 9, "url": "https://api-all-access.cybermax-tools.workers.dev/?s=openapi-recallroll-api", "plans": [ { "id": "all-access", "price": 119, "billing": "per month", "callsHere": 2000, "per": "calendar month (UTC)" }, { "id": "all-access-pack", "price": 32, "billing": "one-time", "callsHere": 400, "per": "until used" } ], "note": "One key for every CyberMax API; Recallroll counts it separately." }, "payments": "Stripe Checkout: card, Apple Pay, Google Pay, Link; sales tax/VAT handled by Stripe. Cancel any time at https://recallroll-api.cybermax-tools.workers.dev/manage." } }, "servers": [ { "url": "https://recallroll-api.cybermax-tools.workers.dev" } ], "paths": { "/api/check": { "get": { "tags": [ "Recallroll" ], "summary": "Decode VINs and list their safety recalls (up to 10 per call)", "description": "For each VIN: check-digit validation, the decoded vehicle (year, make, model, trim, body, engine, drive, plant, GVWR) and every NHTSA recall campaign for that make/model/year, Do Not Drive and Park Outside first, with remedy and campaign link.", "operationId": "checkVinsGet", "parameters": [ { "name": "vin", "in": "query", "required": false, "description": "One VIN, or up to 10 separated by commas (or POST {\"vins\": [...]})", "schema": { "type": "string" }, "example": "1HGCM82633A004352" }, { "name": "full", "in": "query", "required": false, "description": "Full recall text (consequence, notes) instead of the short form", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "results": [ { "vin": "1C4HJXEG7MW123456", "status": "recalls_found", "vehicle": { "year": "2021", "make": "JEEP", "model": "Wrangler", "trim": "Unlimited Sahara", "series": "", "body": "Sport Utility Vehicle [SUV]/Multipurpose Vehicle [MPV]", "type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)", "engine": "3.6 L · 6 cyl · Gasoline", "drive": "4WD/4-Wheel Drive/4x4", "plant": "TOLEDO, OHIO, UNITED STATES (USA)", "manufacturer": "FCA US LLC", "gvwr": "Class 1D: 5,001 - 6,000 lb (2,268 - 2,722 kg)" }, "recallCount": 15, "doNotDrive": 0, "parkOutside": 3, "overTheAir": 0, "newestRecall": "2026-06-04", "recalls": [ { "campaign": "26V363000", "date": "2026-06-04", "component": "STEERING:HYDRAULIC POWER ASSIST:PUMP", "summary": "Chrysler (FCA US, LLC) is recalling certain 2021-2025 Jeep Wrangler, Wrangler 4XE, and Jeep Gladiator vehicles. The electric hydraulic power steering pump wiring may overheat and cause a vehicle fire, even when the vehicle is parked with the ignition in the \"Off\" position.", "remedy": "Owners are advised to park outside and away from structures, until their vehicle is repaired. Dealers will inspect and replace the wiring and electric hydraulic power steering pump, as necessary, free", "doNotDrive": false, "parkOutside": true, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=26V363000" }, { "campaign": "25V741000", "date": "2025-10-30", "component": "ELECTRICAL SYSTEM:PROPULSION SYSTEM:TRACTION BATTERY", "summary": "Chrysler (FCA US, LLC) is recalling certain 2020-2025 Jeep Wrangler 4Xe and 2022-2026 Grand Cherokee 4Xe vehicles. The high voltage battery may fail internally and lead to a vehicle fire while parked or driving.", "remedy": "Owners are advised to park outside and away from structures and not to charge their vehicles until the remedy is completed. Dealers will update the high voltage battery software, and replace the high ", "doNotDrive": false, "parkOutside": true, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=25V741000" } ], "modelsQueried": [ "WRANGLER" ], "checkAt": "https://www.nhtsa.gov/recalls?vin=1C4HJXEG7MW123456" }, { "vin": "5XYP3DHC6LG123456", "status": "recalls_found", "vehicle": { "year": "2020", "make": "KIA", "model": "Telluride", "trim": "EX", "series": "", "body": "Sport Utility Vehicle [SUV]/Multipurpose Vehicle [MPV]", "type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)", "engine": "3.8 L · 6 cyl · Gasoline", "drive": "4WD/4-Wheel Drive/4x4", "plant": "GEORGIA, UNITED STATES (USA)", "manufacturer": "KIA GEORGIA, INC", "gvwr": "Class 1D: 5,001 - 6,000 lb (2,268 - 2,722 kg)" }, "recallCount": 7, "doNotDrive": 0, "parkOutside": 3, "overTheAir": 0, "newestRecall": "2026-07-02", "recalls": [ { "campaign": "26V430000", "date": "2026-07-02", "component": "SEATS:FRONT ASSEMBLY:POWER ADJUST", "summary": "Kia America, Inc. (Kia) is recalling certain 2020-2024 Telluride vehicles. The front power seat motor may overheat due to a stuck power seat slide knob or an improper recall 24V407 repair, which can result in a fire while parked or driving.", "remedy": "Owners are advised to park outside and away from structures until the recall repair is complete. Dealers will install an electronic fuse assembly, free of charge. Owner notification letters are expect", "doNotDrive": false, "parkOutside": true, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=26V430000" }, { "campaign": "24V407000", "date": "2024-06-05", "component": "SEATS:FRONT ASSEMBLY:POWER ADJUST", "summary": "Kia America, Inc. (Kia) is recalling certain 2020-2024 Telluride vehicles. The front power seat motor may overheat due to a stuck power seat slide knob, which can result in a fire while parked or driving.", "remedy": "Owners are advised to park outside and away from structures until the recall repair is complete. Dealers will install a bracket for the power seat switch back covers and replace the seat slide knobs,", "doNotDrive": false, "parkOutside": true, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=24V407000" } ], "modelsQueried": [ "TELLURIDE" ], "checkAt": "https://www.nhtsa.gov/recalls?vin=5XYP3DHC6LG123456" }, { "vin": "1FTBR1C85RKA12345", "status": "recalls_found", "vehicle": { "year": "2024", "make": "FORD", "model": "Transit", "trim": "Medium Roof", "series": "250", "body": "Cargo Van", "type": "TRUCK", "engine": "3.5 L · 6 cyl · Gasoline", "drive": "RWD/Rear-Wheel Drive", "plant": "KANSAS CITY, MISSOURI, UNITED STATES (USA)", "manufacturer": "FORD MOTOR COMPANY", "gvwr": "Class 2H: 9,001 - 10,000 lb (4,082 - 4,536 kg)" }, "recallCount": 10, "doNotDrive": 0, "parkOutside": 0, "overTheAir": 0, "newestRecall": "2026-02-03", "recalls": [ { "campaign": "26V061000", "date": "2026-02-03", "component": "STRUCTURE:FRAME AND MEMBERS", "summary": "Ford Motor Company (Ford) is recalling certain 2023-2024 Transit vehicles. The engine crossmember may not be secured properly, which can cause the engine to shift and possibly result in a loss of drive power or brake failure.", "remedy": "Dealers will replace the cross member fasteners, free of charge. Owner notification letters were mailed May 22, 2026. Owners may contact Ford customer service at 1-866-436-7332. Ford's number for thi", "doNotDrive": false, "parkOutside": false, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=26V061000" }, { "campaign": "25V876000", "date": "2025-12-17", "component": "EQUIPMENT ADAPTIVE/MOBILITY:WHEELCHAIR RESTRAINTS/SECUREMENT:LATCH/ANCHOR:", "summary": "Rollx Vans (Rollx) is recalling certain GMC Yukon, Sierra, Chevrolet Express 2500, Ford Transit, E-250, Toyota Sienna, Sienna Hybrid, Honda Odyssey, Chrysler Town and Country, Voyager, Pacifica, Dodge Grand Caravan, and Ram Promaster vehicles equipped with QRT-Deluxe and QRT-Max ", "remedy": "Rollx will work with Q'Straint to inspect and replace the retractors as necessary, free of charge. Owner notification letters were mailed February 5, 2026. Owners may contact Rollx's customer service ", "doNotDrive": false, "parkOutside": false, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=25V876000" } ], "modelsQueried": [ "TRANSIT" ], "checkAt": "https://www.nhtsa.gov/recalls?vin=1FTBR1C85RKA12345" } ], "count": 3, "summary": { "vins": 3, "decoded": 3, "withRecalls": 3, "withDoNotDriveOrParkOutside": 2 }, "note": "Recalls are those NHTSA lists for the vehicle's make, model and model year. Whether a specific VIN is affected or already repaired is confirmed at checkAt (NHTSA) or by a dealer; recall repairs are free.", "source": "NHTSA vPIC + NHTSA Recalls API", "checkedAt": "2026-09-27T04:19:26.813Z" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Recallroll" ], "summary": "Decode VINs and list their safety recalls (up to 10 per call)", "description": "For each VIN: check-digit validation, the decoded vehicle (year, make, model, trim, body, engine, drive, plant, GVWR) and every NHTSA recall campaign for that make/model/year, Do Not Drive and Park Outside first, with remedy and campaign link.", "operationId": "checkVinsPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "vins": { "type": "array", "items": { "type": "string" }, "maxItems": 10 }, "full": { "type": "boolean" } } }, "example": { "vins": [ "1HGCM82633A004352", "1FTFW1ET5DFC10312" ] } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "results": [ { "vin": "1C4HJXEG7MW123456", "status": "recalls_found", "vehicle": { "year": "2021", "make": "JEEP", "model": "Wrangler", "trim": "Unlimited Sahara", "series": "", "body": "Sport Utility Vehicle [SUV]/Multipurpose Vehicle [MPV]", "type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)", "engine": "3.6 L · 6 cyl · Gasoline", "drive": "4WD/4-Wheel Drive/4x4", "plant": "TOLEDO, OHIO, UNITED STATES (USA)", "manufacturer": "FCA US LLC", "gvwr": "Class 1D: 5,001 - 6,000 lb (2,268 - 2,722 kg)" }, "recallCount": 15, "doNotDrive": 0, "parkOutside": 3, "overTheAir": 0, "newestRecall": "2026-06-04", "recalls": [ { "campaign": "26V363000", "date": "2026-06-04", "component": "STEERING:HYDRAULIC POWER ASSIST:PUMP", "summary": "Chrysler (FCA US, LLC) is recalling certain 2021-2025 Jeep Wrangler, Wrangler 4XE, and Jeep Gladiator vehicles. The electric hydraulic power steering pump wiring may overheat and cause a vehicle fire, even when the vehicle is parked with the ignition in the \"Off\" position.", "remedy": "Owners are advised to park outside and away from structures, until their vehicle is repaired. Dealers will inspect and replace the wiring and electric hydraulic power steering pump, as necessary, free", "doNotDrive": false, "parkOutside": true, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=26V363000" }, { "campaign": "25V741000", "date": "2025-10-30", "component": "ELECTRICAL SYSTEM:PROPULSION SYSTEM:TRACTION BATTERY", "summary": "Chrysler (FCA US, LLC) is recalling certain 2020-2025 Jeep Wrangler 4Xe and 2022-2026 Grand Cherokee 4Xe vehicles. The high voltage battery may fail internally and lead to a vehicle fire while parked or driving.", "remedy": "Owners are advised to park outside and away from structures and not to charge their vehicles until the remedy is completed. Dealers will update the high voltage battery software, and replace the high ", "doNotDrive": false, "parkOutside": true, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=25V741000" } ], "modelsQueried": [ "WRANGLER" ], "checkAt": "https://www.nhtsa.gov/recalls?vin=1C4HJXEG7MW123456" }, { "vin": "5XYP3DHC6LG123456", "status": "recalls_found", "vehicle": { "year": "2020", "make": "KIA", "model": "Telluride", "trim": "EX", "series": "", "body": "Sport Utility Vehicle [SUV]/Multipurpose Vehicle [MPV]", "type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)", "engine": "3.8 L · 6 cyl · Gasoline", "drive": "4WD/4-Wheel Drive/4x4", "plant": "GEORGIA, UNITED STATES (USA)", "manufacturer": "KIA GEORGIA, INC", "gvwr": "Class 1D: 5,001 - 6,000 lb (2,268 - 2,722 kg)" }, "recallCount": 7, "doNotDrive": 0, "parkOutside": 3, "overTheAir": 0, "newestRecall": "2026-07-02", "recalls": [ { "campaign": "26V430000", "date": "2026-07-02", "component": "SEATS:FRONT ASSEMBLY:POWER ADJUST", "summary": "Kia America, Inc. (Kia) is recalling certain 2020-2024 Telluride vehicles. The front power seat motor may overheat due to a stuck power seat slide knob or an improper recall 24V407 repair, which can result in a fire while parked or driving.", "remedy": "Owners are advised to park outside and away from structures until the recall repair is complete. Dealers will install an electronic fuse assembly, free of charge. Owner notification letters are expect", "doNotDrive": false, "parkOutside": true, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=26V430000" }, { "campaign": "24V407000", "date": "2024-06-05", "component": "SEATS:FRONT ASSEMBLY:POWER ADJUST", "summary": "Kia America, Inc. (Kia) is recalling certain 2020-2024 Telluride vehicles. The front power seat motor may overheat due to a stuck power seat slide knob, which can result in a fire while parked or driving.", "remedy": "Owners are advised to park outside and away from structures until the recall repair is complete. Dealers will install a bracket for the power seat switch back covers and replace the seat slide knobs,", "doNotDrive": false, "parkOutside": true, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=24V407000" } ], "modelsQueried": [ "TELLURIDE" ], "checkAt": "https://www.nhtsa.gov/recalls?vin=5XYP3DHC6LG123456" }, { "vin": "1FTBR1C85RKA12345", "status": "recalls_found", "vehicle": { "year": "2024", "make": "FORD", "model": "Transit", "trim": "Medium Roof", "series": "250", "body": "Cargo Van", "type": "TRUCK", "engine": "3.5 L · 6 cyl · Gasoline", "drive": "RWD/Rear-Wheel Drive", "plant": "KANSAS CITY, MISSOURI, UNITED STATES (USA)", "manufacturer": "FORD MOTOR COMPANY", "gvwr": "Class 2H: 9,001 - 10,000 lb (4,082 - 4,536 kg)" }, "recallCount": 10, "doNotDrive": 0, "parkOutside": 0, "overTheAir": 0, "newestRecall": "2026-02-03", "recalls": [ { "campaign": "26V061000", "date": "2026-02-03", "component": "STRUCTURE:FRAME AND MEMBERS", "summary": "Ford Motor Company (Ford) is recalling certain 2023-2024 Transit vehicles. The engine crossmember may not be secured properly, which can cause the engine to shift and possibly result in a loss of drive power or brake failure.", "remedy": "Dealers will replace the cross member fasteners, free of charge. Owner notification letters were mailed May 22, 2026. Owners may contact Ford customer service at 1-866-436-7332. Ford's number for thi", "doNotDrive": false, "parkOutside": false, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=26V061000" }, { "campaign": "25V876000", "date": "2025-12-17", "component": "EQUIPMENT ADAPTIVE/MOBILITY:WHEELCHAIR RESTRAINTS/SECUREMENT:LATCH/ANCHOR:", "summary": "Rollx Vans (Rollx) is recalling certain GMC Yukon, Sierra, Chevrolet Express 2500, Ford Transit, E-250, Toyota Sienna, Sienna Hybrid, Honda Odyssey, Chrysler Town and Country, Voyager, Pacifica, Dodge Grand Caravan, and Ram Promaster vehicles equipped with QRT-Deluxe and QRT-Max ", "remedy": "Rollx will work with Q'Straint to inspect and replace the retractors as necessary, free of charge. Owner notification letters were mailed February 5, 2026. Owners may contact Rollx's customer service ", "doNotDrive": false, "parkOutside": false, "ota": false, "url": "https://www.nhtsa.gov/recalls?nhtsaId=25V876000" } ], "modelsQueried": [ "TRANSIT" ], "checkAt": "https://www.nhtsa.gov/recalls?vin=1FTBR1C85RKA12345" } ], "count": 3, "summary": { "vins": 3, "decoded": 3, "withRecalls": 3, "withDoNotDriveOrParkOutside": 2 }, "note": "Recalls are those NHTSA lists for the vehicle's make, model and model year. Whether a specific VIN is affected or already repaired is confirmed at checkAt (NHTSA) or by a dealer; recall repairs are free.", "source": "NHTSA vPIC + NHTSA Recalls API", "checkedAt": "2026-09-27T04:19:26.813Z" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/recalls": { "get": { "tags": [ "Recallroll" ], "summary": "Safety recalls for a make, model and model year (no VIN needed)", "description": "Every NHTSA recall campaign for the vehicle, Do Not Drive and Park Outside first, with component, summary, remedy, over-the-air flag and campaign link.", "operationId": "vehicleRecallsGet", "parameters": [ { "name": "make", "in": "query", "required": false, "description": "Make, e.g. Ford", "schema": { "type": "string" }, "example": "Ford" }, { "name": "model", "in": "query", "required": false, "description": "Model, e.g. F-150 (NHTSA spellings are matched for you)", "schema": { "type": "string" }, "example": "F-150" }, { "name": "year", "in": "query", "required": false, "description": "Model year", "schema": { "type": "integer" }, "example": "2021" }, { "name": "full", "in": "query", "required": false, "description": "Full recall text", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Recallroll" ], "summary": "Safety recalls for a make, model and model year (no VIN needed)", "description": "Every NHTSA recall campaign for the vehicle, Do Not Drive and Park Outside first, with component, summary, remedy, over-the-air flag and campaign link.", "operationId": "vehicleRecallsPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "make": { "type": "string" }, "model": { "type": "string" }, "year": { "type": "integer" }, "full": { "type": "boolean" } }, "required": [ "make", "model", "year" ] }, "example": { "make": "Ford", "model": "F-150", "year": 2021 } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" }, "retryAfterSeconds": { "type": "integer" }, "limits": { "type": "object" } }, "required": [ "error", "message" ] } }, "securitySchemes": { "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Optional. Paid plan key from https://recallroll-api.cybermax-tools.workers.dev/docs#pricing; leave out for the free tier." }, "BearerKey": { "type": "http", "scheme": "bearer", "description": "Same key as a Bearer token." } } }, "x-mcp-server": "https://recallroll-api.cybermax-tools.workers.dev/mcp", "externalDocs": { "description": "Get an API key (pricing)", "url": "https://recallroll-api.cybermax-tools.workers.dev/docs#pricing" }, "security": [ {}, { "ApiKeyHeader": [] }, { "BearerKey": [] } ] }