{"openapi":"3.1.0","info":{"title":"Auto.dev (BYOK) API","version":"0.1.0","description":"Auto.dev (BYOK) lets an AI assistant read your own Auto.dev data through the Auto.dev API with a key you supply (Auto.dev API key). Read-only: 8 tools (decode_vin, search_listings, get_listing, get_vehicle_specs, get_vehicle_recalls, get_vehicle_photos, get_interest_rates, get_total_cost_of_ownership). The BYOK key travels with each request, is used for that one call only and is never stored,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-autodev.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-autodev/docs"},"termsOfService":"https://connectorbay.com/byok-autodev/terms"},"servers":[{"url":"https://byok-autodev.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-autodev/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/decode_vin":{"post":{"operationId":"decode_vin","summary":"Decode a VIN into make, model, trim, body, engine, drive and transmission; ambiguous VINs return candidate years and a r","description":"Decode a VIN into make, model, trim, body, engine, drive and transmission; ambiguous VINs return candidate years and a reason instead. Use for \"What vehicle is VIN 1HGCM82633A004352\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"description":"17-character vehicle identification number (letters I, O and Q are not used).","maxLength":17,"title":"Vin","type":"string"}},"required":["vin"],"title":"decode_vinArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_listings":{"post":{"operationId":"search_listings","summary":"Search vehicle listings by make, model, year, price, mileage, state, new or used and distance from a ZIP code; returns a","description":"Search vehicle listings by make, model, year, price, mileage, state, new or used and distance from a ZIP code; returns a page of listings with dealer, price and photo link. The per-page cap depends on your plan. Use for \"Find used Honda Accords from 2018 to 2021 under 25000 within 50 miles of 94025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vehicle_year":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Model year or a range like 2018-2020.","title":"Vehicle Year"},"vehicle_make":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Make; several separated by commas.","title":"Vehicle Make"},"vehicle_model":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Model; several separated by commas.","title":"Vehicle Model"},"vehicle_trim":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Trim; several separated by commas.","title":"Vehicle Trim"},"vehicle_body_style":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Body style such as sedan or coupe; several separated by commas.","title":"Vehicle Body Style"},"vehicle_fuel":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Fuel: Gasoline, Hybrid, Electric, Plug-In Hybrid or Diesel; several separated by commas.","title":"Vehicle Fuel"},"vehicle_exterior_color":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Exterior colour; several separated by commas.","title":"Vehicle Exterior Color"},"price":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Price range such as 10000-20000.","title":"Price"},"miles":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Mileage range such as 10000-60000.","title":"Miles"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Dealer state code, for example CA.","title":"State"},"used":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for used vehicles, false for new.","title":"Used"},"certified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for certified pre-owned vehicles only.","title":"Certified"},"zip":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit ZIP code that centres a radius search.","title":"Zip"},"distance":{"anyOf":[{"maximum":5000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Radius in miles around zip (the service defaults to 50).","title":"Distance"},"include_unpriced":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include listings with no price.","title":"Include Unpriced"},"sort":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"One field and direction, for example price.asc; fields are createdAt, updatedAt, price, miles and year.","title":"Sort"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Listings per page (1 to 500, capped by your plan).","title":"Limit"},"page":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"includes":{"anyOf":[{"const":"total","type":"string"},{"type":"null"}],"default":null,"description":"Set to total to add the count of matching listings.","title":"Includes"}},"title":"search_listingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_listing":{"post":{"operationId":"get_listing","summary":"Get the current listing for a VIN: vehicle details, price, dealer, city, state, listing page link and photo count; a rem","description":"Get the current listing for a VIN: vehicle details, price, dealer, city, state, listing page link and photo count; a removed vehicle returns its last stored listing. Use for \"Is VIN 1HGCM82633A004352 listed for sale and at what price\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"description":"17-character vehicle identification number (letters I, O and Q are not used).","maxLength":17,"title":"Vin","type":"string"}},"required":["vin"],"title":"get_listingArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_vehicle_specs":{"post":{"operationId":"get_vehicle_specs","summary":"Get full factory specifications for a VIN: base MSRP and invoice, seating, colours, engine, fuel, measurements, drivetra","description":"Get full factory specifications for a VIN: base MSRP and invoice, seating, colours, engine, fuel, measurements, drivetrain, warranty and safety features. Listed under the Growth plan or higher. Use for \"Give me the specifications for VIN 1HGCM82633A004352\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"description":"17-character vehicle identification number (letters I, O and Q are not used).","maxLength":17,"title":"Vin","type":"string"}},"required":["vin"],"title":"get_vehicle_specsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_vehicle_recalls":{"post":{"operationId":"get_vehicle_recalls","summary":"List recall records for a VIN: campaign number, component, summary, consequence, remedy and whether to park the vehicle.","description":"List recall records for a VIN: campaign number, component, summary, consequence, remedy and whether to park the vehicle. Listed under the Growth plan or higher. Use for \"Does VIN 1HGCM82633A004352 have any recalls\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"description":"17-character vehicle identification number (letters I, O and Q are not used).","maxLength":17,"title":"Vin","type":"string"}},"required":["vin"],"title":"get_vehicle_recallsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_vehicle_photos":{"post":{"operationId":"get_vehicle_photos","summary":"Get retail photo links for a VIN. Use for \"Show photos of VIN 1HGCM82633A004352\".","description":"Get retail photo links for a VIN. Use for \"Show photos of VIN 1HGCM82633A004352\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"description":"17-character vehicle identification number (letters I, O and Q are not used).","maxLength":17,"title":"Vin","type":"string"}},"required":["vin"],"title":"get_vehicle_photosArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_interest_rates":{"post":{"operationId":"get_interest_rates","summary":"Get estimated auto loan APRs by term for a VIN, ZIP code and credit score. Listed under the Growth plan or higher. Use f","description":"Get estimated auto loan APRs by term for a VIN, ZIP code and credit score. Listed under the Growth plan or higher. Use for \"What APR could I get on VIN 1HGCM82633A004352 in 94025 with a 720 credit score\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"description":"17-character vehicle identification number (letters I, O and Q are not used).","maxLength":17,"title":"Vin","type":"string"},"year":{"anyOf":[{"maximum":2100,"minimum":1950,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year.","title":"Year"},"make":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Manufacturer.","title":"Make"},"model":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Model name.","title":"Model"},"zip":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit ZIP code (or ZIP+4).","title":"Zip"},"credit_score":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Credit score used for the rate.","title":"Credit Score"},"vehicle_age":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Vehicle age in years.","title":"Vehicle Age"},"vehicle_mileage":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Current mileage.","title":"Vehicle Mileage"}},"required":["vin"],"title":"get_interest_ratesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_total_cost_of_ownership":{"post":{"operationId":"get_total_cost_of_ownership","summary":"Estimate five-year total cost of ownership for a VIN: insurance, maintenance, repairs, taxes and fees, finance interest,","description":"Estimate five-year total cost of ownership for a VIN: insurance, maintenance, repairs, taxes and fees, finance interest, depreciation and fuel, in total and per year. Listed under the Growth plan or higher. Use for \"What will VIN 1HGCM82633A004352 cost me to own over five years in 94025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"description":"17-character vehicle identification number (letters I, O and Q are not used).","maxLength":17,"title":"Vin","type":"string"},"zip":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit ZIP code (or ZIP+4) for local insurance, taxes and fees.","title":"Zip"},"from_zip":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit ZIP code for delivery or transport costs.","title":"From Zip"}},"required":["vin"],"title":"get_total_cost_of_ownershipArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}