# BookDMV
> Real-time DMV appointment wait times and automatic booking across 13 US states and 790+ offices.

BookDMV is a DMV appointment notifier and booking service. It monitors DMV appointment availability across 13 states and sends instant email and SMS notifications when slots open. Users can set up Slot Alerts (DMV appointment notifications) to get notified when openings appear, or use Auto-Book to have an appointment secured automatically.

## DMV Wait Times by State

States with Auto-Book support (alerts + automatic booking):
- [California DMV](https://bookdmv.app/wait-times/california): 185 offices, 13 services
- [Texas DMV](https://bookdmv.app/wait-times/texas): 120 offices
- [North Carolina DMV](https://bookdmv.app/wait-times/north-carolina): 100 offices, 9 services
- [Virginia DMV](https://bookdmv.app/wait-times/virginia): 76 offices, 15 service types
- [Florida DMV](https://bookdmv.app/wait-times/florida): 53 offices, Auto-Book in most counties (Broward and Miami-Dade excluded)
- [New Jersey DMV](https://bookdmv.app/wait-times/new-jersey): 44 offices, 17 services
- [Illinois DMV](https://bookdmv.app/wait-times/illinois): 43 offices
- [Colorado DMV](https://bookdmv.app/wait-times/colorado): 41 offices, state + county offices
- [Hawaii DMV](https://bookdmv.app/wait-times/hawaii): 31 offices, 4 counties
- [New York DMV](https://bookdmv.app/wait-times/new-york): 28 offices, 15 services

States with Slot Alerts only (appointment monitoring, no automatic booking):
- [Washington DOL](https://bookdmv.app/wait-times/washington): 42 offices, 5 DL services
- [Nevada DMV](https://bookdmv.app/wait-times/nevada): 17 offices
- [Connecticut DMV](https://bookdmv.app/wait-times/connecticut): 14 offices, 3 service groups

## Key Facts
- Data is based on real appointment availability, not estimates or walk-in wait times
- Covers approximately 199 million people across 13 states
- Auto-Book supported in 10 states: CA, TX, NC, VA, FL, NJ, IL, CO, HI, NY
- All 13 states support Slot Alerts (instant notifications when appointments open)

## Services
- [All States Overview](https://bookdmv.app/wait-times): Current wait times, trends, and availability
- [Pricing](https://bookdmv.app/pricing): Slot Alert ($7.50/30 days) and Auto-Book ($14.50/appointment)
- [FAQ](https://bookdmv.app/faq): How monitoring, alerts, and automatic booking work
- [Contact](https://bookdmv.app/contact): support@bookdmv.app

## Agent API (Machine-to-Machine)
AI agents can programmatically query DMV data and book appointments via the Agent API at api.bookdmv.app.

### Endpoints
- `GET /agent/offices/nearby` - Find nearest DMV offices by GPS, address, or zip ($0.05/call)
- `GET /agent/availability/:state/:officeId?serviceId=` - Real-time slot availability ($0.10/call, includes free refresh token for polling)
- `POST /agent/book/validate` - Pre-flight booking validation (free)
- `POST /agent/book` - Instant DMV appointment booking ($5.00/call, booking credit on infrastructure failure)

### Payment Flow
All paid endpoints use the HTTP 402 Payment Required challenge pattern:
1. Agent sends request without payment credentials
2. Server responds 402 with pricing and payment method details
3. Agent pays with USDC (x402) or stablecoins (Tempo) and retries with proof
4. Server verifies payment and returns data

### Payment Methods
- x402 (Coinbase): USDC on Base. $0.001/tx, free under 1,000 tx/month. Lowest cost.
- Tempo (Stripe): Stablecoins. 1.5% flat fee, no fixed per-transaction cost.
- SPT (Stripe Cards): Shared Payment Tokens. Only on /agent/book ($5+). 2.9% + $0.30.

### Booking Support
Instant booking available in 10 states: CA, TX, NC, VA, FL, NJ, IL, CO, HI, NY.
Availability data available in all 13 states.
No API keys or accounts needed. Payment is the authentication.

### Integration
- x402 client: `@x402/fetch` npm package (wraps fetch with automatic 402 handling)
- MPP client: `mppx/client` npm package (Tempo and SPT payment support)
- Documentation: https://bookdmv.app/agents