autograb

Vehicle lookup, marketplace pricing, sourcing valuation, and Tailpipe/Autograb mapping endpoints.

Field	Value
Serverless service	`drive-api-autograb`
Runtime	`nodejs22.x, arm64`
Deployed HTTP operations	10
Local worker harnesses	0
API-key operations	`GET /ag/tailpipe/lookup`, `GET /ag/marketplace/pricegauge`
OpenAPI	`/openapi/autograb.yaml` · interactive

Deployed routes

Function	Method	Path	Auth	Input	Output
`vehicleLookupTailpipe`	GET	`/ag/tailpipe/lookup`	API key	Query `id`	`{requestId, agVehicle, vehicles[], success}` or `204` on empty upstream
`vehicle`	GET	`/ag/vehicle`	Public	Query `id`	Autograb vehicle object or `204` on no match
`vehicleSearch`	GET	`/ag/vehicles`	Public	Query `search` plus optional filters	Autograb search result object or `204` on no matches
`regoLookup`	GET	`/ag/rego/{state}/{rego}`	Public	Path `state`, `rego`	`{rego, state, numVehicles, vehicles[], regoLookupResponse, success}` with ETag
`vinLookup`	GET	`/ag/vin/{vin}`	Public	Path `vin`	`{vin, numVehicles, vehicles[], vinLookupResponse, success}` with ETag
`vehicleSearchMarketplace`	GET	`/ag/marketplace/vehicles`	Public	Query `stock_id`, `description`, optional vehicle hints	Marketplace vehicle match response with ETag
`priceGauge`	GET	`/ag/marketplace/pricegauge`	API key	Query `stockId`	Price gauge payload for a stock listing
`vehicleResiduals`	POST	`/ag/sourcing/residuals`	Public	`VehicleResidualsRequest`	Residual value response
`vehicleMarketOverlay`	POST	`/ag/sourcing/marketoverlay`	Public	`VehicleMarketOverlayRequest`	Market overlay response
`vehicleValuePrediction`	GET	`/ag/sourcing/valuation`	Public	Query vehicle or rego/state identifiers	`VehicleValuationResponse`

Event-driven workers

driveAwayGuideRequestProcess and fetchDriveAwayGuide are SQS workers, not deployed HTTP routes and not local HTTP harnesses in the current OpenAPI spec. They process FIFO drive-away-guide queues declared in services/autograb/serverless.yml.

Behaviour notes

Rego and VIN lookups validate state/VIN before calling Autograb and use ETag-aware responses.
Marketplace vehicle search requires stock_id and description; it is not a general search endpoint.
Residual, market-overlay, valuation, and value-prediction handlers use DynamoDB cache records with default 30-day TTLs unless cacheTtlInDays overrides them.
priceGauge uses a 7-day DynamoDB cache TTL.
Valuation applies tradePriceMultiplierMin and tradePriceMultiplierMax environment defaults when building trade price bounds.

Source map

Routes and auth: services/autograb/serverless.yml
Handlers: services/autograb/functions/
Request/response types: services/autograb/types/
Tailpipe/Autograb mapping: services/autograb/util/autograbToTailpipe.ts