# AmtsGuide
> Structured German Verwaltung data, calculators, and source-backed facts for bureaucracy workflows across Germany.

## About
AmtsGuide helps people and agents work with German bureaucratic processes through jurisdiction-scoped facts, calculators, finders, and step-by-step guides. Available in German and English.

## Structured Data API
Canonical API URL: https://api.amtsguide.de/api/v1/
Current web URL: https://amtsguide.de/api/v1/

All endpoints return JSON with a consistent envelope: { data, meta: { source, version, generated_at, endpoint } }
Cache: public, max-age=3600. CORS enabled.
API access is a Stage 1 product probe: anonymous discovery and small reads are public; free keyed access and paid/bulk tiers are planned but not required for current public endpoints.

### Data Confidence
Every page and fact can carry confidence, source, and freshness metadata:
- **verified**: source-checked record with timestamped evidence or review metadata
- **unverified**: auto-collected or generated from official sources and still pending source review
Prefer API endpoints and calculator routes over browser automation against government websites. Confidence is shown on pages where available and is included in API responses where supported.

### Endpoint Index
- GET /api/v1/ — List all available endpoints

### Hunting License (Jagdschein) Facts
- GET /api/v1/jagdschein/facts/ — All 16 German states: training hours, exam windows, costs, authorities
- GET /api/v1/jagdschein/facts/{state}/ — Single state (e.g., bayern, berlin, hamburg)
- GET /api/v1/jagdschein/detail/ — Full detail data for all 16 states (costs per license type, documents, application methods)
- GET /api/v1/jagdschein/detail/{state}/ — Single state detail

### Halteverbot (Parking Ban) Calculator
- GET /api/v1/calculator/halteverbot/ — Processing times and costs for 24 locations (11 cities + 13 Berlin districts)
- GET /api/v1/calculator/halteverbot/results/ — Pre-computed results for all 576 origin/destination pairs
- GET /api/v1/calculator/halteverbot/results/{von}/{nach}/ — Single pair (e.g., hamburg/dortmund); accepts optional ?datum=YYYY-MM-DD for urgency and schedule fields

### Hunting License Calculator
- GET /api/v1/calculator/jagdschein/results/ — Pre-computed cost estimates and timelines for all 16 states
- GET /api/v1/calculator/jagdschein/results/{state}/ — Single state (training duration, exam info, total costs)

### EV Subsidy Calculator
- GET /api/v1/calculator/e-auto/results/ — All 24 BEV/PHEV income and children subsidy combinations
- GET /api/v1/calculator/e-auto/results/{fahrzeugtyp}/{bracket}/{kinder}/ — Single EV subsidy estimate; fahrzeugtyp is BEV or PHEV, bracket is 0-3, kinder is 0-2

### Wallbox Calculator
- GET /api/v1/calculator/wallbox/results/ — All baseline property, parking-space, wallbox type, and distance combinations without PLZ
- GET /api/v1/calculator/wallbox/results/{immobilientyp}/{stellplaetze}/{wallboxTyp}/{entfernung}/ — Single Wallbox cost estimate; accepts optional ?plz=12345 for Stadtwerk lookup

### Balkonkraftwerk Calculator
- GET /api/v1/calculator/balkonkraftwerk/results/ — Baseline payback estimates for active subsidy cities plus the no-city default
- GET /api/v1/calculator/balkonkraftwerk/results/{city}/{leistung}/ — Single payback estimate; city can be none, accepts optional ?preis=399&strom=0.31

### GmbH Calculator
- GET /api/v1/calculator/gmbh/results/ — GmbH founding-cost estimates for every supported city and contract type; totals exclude Stammkapital and annual IHK contribution
- GET /api/v1/calculator/gmbh/results/{city}/{gesellschaftsvertrag}/ — Single GmbH cost estimate; gesellschaftsvertrag is muster or individuell

### Sachkunde 34a Calculator
- GET /api/v1/calculator/sachkunde34a/results/ — Sachkunde 34a exam-fee and preparation-cost estimates for every supported city and course format
- GET /api/v1/calculator/sachkunde34a/results/{city}/ — Single Sachkunde 34a cost estimate by city slug or simple 5-digit PLZ lookup; accepts optional ?kursformat=median

### AEVO Calculator
- GET /api/v1/calculator/aevo/results/ — AEVO cost estimates for every supported city and course format
- GET /api/v1/calculator/aevo/results/{city}/{kursformat}/ — Single AEVO cost estimate; kursformat is guenstig, median, or intensiv

### Heat Pump Calculator
- GET /api/v1/calculator/waermepumpe/results/ — Heat pump grant, own contribution, permit and GEG deadline estimates
- GET /api/v1/calculator/waermepumpe/results/{pumpType}/{populationClass}/ — Single heat pump estimate; accepts optional ?kosten=24000&selbstnutzer=true&alteHeizung=true&einkommenUnter40000=false

### Vehicle Registration Calculator
- GET /api/v1/calculator/kfz/results/ — Vehicle registration fee, document, wait-time, and i-Kfz estimates for all supported city/process combinations
- GET /api/v1/calculator/kfz/results/{city}/{vorgang}/ — Single vehicle registration estimate; vorgang is neuzulassung, halterwechsel, ummeldung, abmeldung, or wiederzulassung

## Available States
baden-wuerttemberg, bayern, berlin, brandenburg, bremen, hamburg, hessen, mecklenburg-vorpommern, niedersachsen, nordrhein-westfalen, rheinland-pfalz, saarland, sachsen, sachsen-anhalt, schleswig-holstein, thueringen

## Available Halteverbot Locations
Cities: berlin, bremen, dortmund, duesseldorf, essen, frankfurt, hamburg, koeln, leipzig, muenchen, stuttgart
Berlin Districts: berlin-charlottenburg, berlin-charlottenburg-wilmersdorf, berlin-friedrichshain-kreuzberg, berlin-lichtenberg, berlin-marzahn-hellersdorf, berlin-mitte, berlin-neukoelln, berlin-pankow, berlin-reinickendorf, berlin-spandau, berlin-steglitz-zehlendorf, berlin-tempelhof-schoeneberg, berlin-treptow-koepenick

## Website
- Homepage: https://amtsguide.de/de/
- English: https://amtsguide.de/en/
- Halteverbot Calculator: https://amtsguide.de/de/halteverbot/rechner/
- Jagdschein Calculator: https://amtsguide.de/de/jagdschein/rechner/
- EV Subsidy Calculator: https://amtsguide.de/en/electric-vehicle-subsidy/calculator/
- Wallbox Calculator: https://amtsguide.de/en/charging-station-subsidy/calculator/
- Balcony Power Plant Calculator: https://amtsguide.de/en/balcony-power-plant/calculator/
- AEVO Calculator: https://amtsguide.de/en/aevo-trainer-certificate/calculator/
- Security Guard Exam §34a Calculator: https://amtsguide.de/en/security-guard-exam-34a/calculator/
- GmbH Formation Calculator: https://amtsguide.de/en/gmbh-formation/calculator/
- Heat Pump Calculator: https://amtsguide.de/en/heat-pump/calculator/
- Vehicle Registration Tool: https://amtsguide.de/en/vehicle-registration/
- Naturopath Comparison Tool: https://amtsguide.de/en/naturopath/comparison/
- Fine Authority Finder: https://amtsguide.de/en/fine-proceedings/calculator/
- Probate Court Finder: https://amtsguide.de/en/certificate-of-inheritance/calculator/
- Wood-Burning Stove City Planner: https://amtsguide.de/en/wood-burning-stove/calculator/
- Dog Owner Certificate City Check: https://amtsguide.de/en/dog-owner-certificate/calculator/
- Master Exam Chamber Finder: https://amtsguide.de/en/master-craftsperson-exam/calculator/

## Contact
- Website: https://amtsguide.de
- Email: info@amtsguide.de