{"openapi":"3.1.0","info":{"title":"ladepreis.app API & Aggregator","description":"Offene Ladesäulen REST-API (AFIR / DATEX II) für Ad-Hoc-Ladepunkte, Echtzeit-Verfügbarkeit, Preise, Blockiergebühren und maximale Ladedauer.\n\n### Datenquellen & Lizenzhinweis (Gemäß CC BY 4.0 / Mobilithek)\nEin Teil der Daten steht unter **Creative Commons Namensnennung 4.0 International (CC BY 4.0)** (https://creativecommons.org/licenses/by/4.0/deed.de) – insbesondere Daten von **EnBW mobility+ (EnBW AG)**, **Eco-Movement**, **GLS Mobility GmbH** und **innocept mobility GmbH** – sowie unter **CC0 1.0** und **Open Data** (Quelle: Mobilithek, https://mobilithek.info). Eine tagesaktuelle Liste aller aktiven Datenquellen und Lizenzen ist jederzeit über `GET /api/v1/sources` abrufbar.","version":"1.0.0"},"paths":{"/api/v1/stations":{"get":{"tags":["Public Charging API v1"],"summary":"Ladesäulen im Umkreis oder nach Filterkriterien suchen","operationId":"list_stations_api_v1_stations_get","parameters":[{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Breitengrad (WGS84) für Umkreissuche","title":"Lat"},"description":"Breitengrad (WGS84) für Umkreissuche"},{"name":"lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Längengrad (WGS84) für Umkreissuche","title":"Lon"},"description":"Längengrad (WGS84) für Umkreissuche"},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","maximum":200.0,"minimum":0.1,"description":"Suchradius in Kilometern","default":10.0,"title":"Radius Km"},"description":"Suchradius in Kilometern"},{"name":"min_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Minimaler Breitengrad für Bounding-Box","title":"Min Lat"},"description":"Minimaler Breitengrad für Bounding-Box"},{"name":"max_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Maximaler Breitengrad für Bounding-Box","title":"Max Lat"},"description":"Maximaler Breitengrad für Bounding-Box"},{"name":"min_lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Minimaler Längengrad für Bounding-Box","title":"Min Lon"},"description":"Minimaler Längengrad für Bounding-Box"},{"name":"max_lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Maximaler Längengrad für Bounding-Box","title":"Max Lon"},"description":"Maximaler Längengrad für Bounding-Box"},{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter nach Stadt/Ort","title":"City"},"description":"Filter nach Stadt/Ort"},{"name":"postal_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter nach Postleitzahl","title":"Postal Code"},"description":"Filter nach Postleitzahl"},{"name":"only_adhoc","in":"query","required":false,"schema":{"type":"boolean","description":"Nur Ladesäulen mit bestätigter Ad-Hoc-Lademöglichkeit","default":false,"title":"Only Adhoc"},"description":"Nur Ladesäulen mit bestätigter Ad-Hoc-Lademöglichkeit"},{"name":"only_available","in":"query","required":false,"schema":{"type":"boolean","description":"Nur Ladesäulen mit mindestens einem freien Ladepunkt","default":false,"title":"Only Available"},"description":"Nur Ladesäulen mit mindestens einem freien Ladepunkt"},{"name":"min_power_kw","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Mindestladeleistung in kW","title":"Min Power Kw"},"description":"Mindestladeleistung in kW"},{"name":"max_price_kwh","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Maximaler Ad-Hoc-Preis in EUR/kWh","title":"Max Price Kwh"},"description":"Maximaler Ad-Hoc-Preis in EUR/kWh"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Stations Api V1 Stations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sources":{"get":{"tags":["Public Charging API v1"],"summary":"Übersicht aller Datenquellen & Lizenzen (Namensnennung gemäß CC BY 4.0)","operationId":"list_data_sources_api_v1_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Data Sources Api V1 Sources Get"}}}}}}},"/api/v1/stations/{station_id}":{"get":{"tags":["Public Charging API v1"],"summary":"Details einer einzelnen Ladesäule abrufen","operationId":"get_station_api_v1_stations__station_id__get","parameters":[{"name":"station_id","in":"path","required":true,"schema":{"type":"integer","title":"Station Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Station Api V1 Stations  Station Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/evse/{evse_id}":{"get":{"tags":["Public Charging API v1"],"summary":"Direktabfrage eines Ladepunkts anhand der offiziellen EVSE-ID","operationId":"get_evse_api_v1_evse__evse_id__get","parameters":[{"name":"evse_id","in":"path","required":true,"schema":{"type":"string","title":"Evse Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Evse Api V1 Evse  Evse Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/geocode":{"get":{"tags":["Public Charging API v1"],"summary":"Schnelle, lokale Ortssuche für Städte, Gemeinden und PLZ (100% DSGVO-konform, kein externer Call)","description":"Sucht Städte, Gemeinden und PLZ-Gebiete direkt aus der lokalen PostGIS-Datenbank.\nGreift für die Ortssuche auf die lokale Datenbank zu.","operationId":"geocode_place_api_v1_geocode_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Suchbegriff (Stadt, Gemeinde oder Postleitzahl)","title":"Q"},"description":"Suchbegriff (Stadt, Gemeinde oder Postleitzahl)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":6,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Geocode Place Api V1 Geocode Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stats":{"get":{"tags":["Public Charging API v1"],"summary":"Öffentliche Live-Statistiken der Ladeinfrastruktur (Echtzeit aus PostgreSQL)","operationId":"get_public_stats_api_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Stats Api V1 Stats Get"}}}}}}},"/tiles/{z}/{x}/{y}.png":{"get":{"tags":["Map Tiles"],"summary":"Kartenkachel abrufen","operationId":"get_tile_tiles__z___x___y__png_get","parameters":[{"name":"z","in":"path","required":true,"schema":{"type":"integer","title":"Z"}},{"name":"x","in":"path","required":true,"schema":{"type":"integer","title":"X"}},{"name":"y","in":"path","required":true,"schema":{"type":"integer","title":"Y"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"tags":["Map Tiles"],"summary":"Kartenkachel abrufen","operationId":"get_tile_tiles__z___x___y__png_get","parameters":[{"name":"z","in":"path","required":true,"schema":{"type":"integer","title":"Z"}},{"name":"x","in":"path","required":true,"schema":{"type":"integer","title":"X"}},{"name":"y","in":"path","required":true,"schema":{"type":"integer","title":"Y"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}