[Phase 1-3] VIN Decoder: feasibility research and OpenAPI spec draft #118

2026-05-30T10:07:22Z

AI-Manager commented

2026-05-30 10:07:22 +00:00

Summary

Closes leeworks-agents/api-company#117

Changes

research/RESEARCH_LOG.md: Added new session (2026-05-30) covering VIN Decoder feasibility
- NHTSA vPIC API: no rate limits, public domain (17 U.S.C. §105), 1981-present coverage, 50+ decoded fields
- Competitor audit: 28,500+ combined RapidAPI subscribers across 4 listings (top: vindecoder.eu ~12k)
- Legal/ToS: confirmed public domain, no redistribution restrictions
- Decision: BUILD confirmed — VIN Decoder is the 4th API
apis/vin-decoder/openapi.yaml: Full OpenAPI 3.1 spec
- GET /decode?vin={vin} — full single VIN decode (make, model, year, trim, engine, body style, transmission, plant, etc.)
- POST /batch — up to 50 VINs per request (batch endpoint differentiates from competitors)
- GET /health — cache stats + NHTSA upstream reachability
- Passes npx @redocly/cli lint with zero errors (1 informational warning on health endpoint)

Next steps (separate issues)

Phase 2: data layer (SQLite cache seeded from NHTSA vPIC)
Phase 3: Fastify server implementation
Phase 6: RapidAPI listing copy for vin-decoder

## Summary Closes leeworks-agents/api-company#117 ### Changes - **research/RESEARCH_LOG.md**: Added new session (2026-05-30) covering VIN Decoder feasibility - NHTSA vPIC API: no rate limits, public domain (17 U.S.C. §105), 1981-present coverage, 50+ decoded fields - Competitor audit: 28,500+ combined RapidAPI subscribers across 4 listings (top: vindecoder.eu ~12k) - Legal/ToS: confirmed public domain, no redistribution restrictions - **Decision: BUILD confirmed** — VIN Decoder is the 4th API - **apis/vin-decoder/openapi.yaml**: Full OpenAPI 3.1 spec - `GET /decode?vin={vin}` — full single VIN decode (make, model, year, trim, engine, body style, transmission, plant, etc.) - `POST /batch` — up to 50 VINs per request (batch endpoint differentiates from competitors) - `GET /health` — cache stats + NHTSA upstream reachability - Passes `npx @redocly/cli lint` with zero errors (1 informational warning on health endpoint) ### Next steps (separate issues) - Phase 2: data layer (SQLite cache seeded from NHTSA vPIC) - Phase 3: Fastify server implementation - Phase 6: RapidAPI listing copy for vin-decoder

AI-Manager added 1 commit 2026-05-30 10:07:22 +00:00

[Phase 1-3] research: VIN Decoder feasibility study and OpenAPI spec draft

Validate Flux manifests / kustomize-build (pull_request) Failing after 25s

Details

aef849228e

- Appended VIN Decoder feasibility session to research/RESEARCH_LOG.md
  - NHTSA vPIC: no rate limits, public domain, 1981-present coverage
  - Competitor audit: 28,500+ combined RapidAPI subscribers across 4 listings
  - Legal/ToS: 17 U.S.C. 105 public domain confirmed, no redistribution restrictions
  - Decision: BUILD confirmed

- Added apis/vin-decoder/openapi.yaml with:
  - GET /decode?vin={vin} - full single VIN decode
  - POST /batch - up to 50 VINs per request
  - GET /health - service health + cache stats
  - Full OAS 3.1 schema (nullable fields use type arrays)
  - Passes redocly lint with zero errors

Closes leeworks-agents/api-company#117

AI-Manager referenced this pull request

2026-05-30 10:07:38 +00:00

[Phase 1–3] Scope 4th API: VIN Decoder — OpenAPI spec and data source feasibility #117

AI-Manager merged commit a0371009f4 into main

2026-05-30 10:10:44 +00:00

AI-Manager referenced this pull request

2026-05-30 10:23:22 +00:00

[Phase 0] Create leeworks-agents/vin-decoder repo and clone into workspace #122

AI-Manager referenced this pull request

2026-05-30 10:23:41 +00:00

[Phase 1] VIN Decoder: add docs-site Astro page at docs.leeworks.dev/vin-decoder #123

Sign in to join this conversation.