Ladedaten für deine Anwendung

Du entwickelst eine App, eine Karte oder ein Dashboard? Mit unserer REST-API bindest du Ladepunkte, Preise und Verfügbarkeiten in dein Projekt ein. Hier findest du alle Funktionen, Codebeispiele und einen Bereich, in dem du Anfragen direkt testen kannst.

Erste Abfrage starten

Wähle ein Beispiel und rufe die Ladepunkte für deinen gewünschten Ort ab.

Anfrage ausprobieren

Die passende Funktion finden

Suche im Umkreis, frage einzelne Ladepunkte ab oder lies nach, woher die Daten stammen.

Alle Funktionen

So greifst du auf die API zu

Rufe die Daten direkt per GET ab. Die Daten-Endpunkte liefern JSON.

Basis-URL
https://v49457.1blu.de/api/v1
Anfragelimit
60 Anfragen innerhalb von 60 Sekunden pro IPv4-Adresse oder IPv6-/64-Netz. Das Limit gilt gemeinsam für alle JSON-Endpunkte. Bei hoher Gesamtauslastung kann ein gemeinsames Limit greifen.

Bei HTTP 429 gibt der Header Retry-After die Wartezeit in Sekunden an. Wenn du regelmäßig dieselben Daten abfragst, speichere die Antwort kurz zwischen.

Deine erste Abfrage

Diese Beispiele suchen bis zu zehn Standorte in Hamm mit mindestens einem als frei gemeldeten Ladepunkt. Die Antwort enthält auch die weiteren Ladepunkte am jeweiligen Standort.

cURL · Freie Ladepunkte suchen
curl --get 'https://v49457.1blu.de/api/v1/stations' \
  --data-urlencode 'city=Hamm' \
  --data-urlencode 'only_available=true' \
  --data-urlencode 'limit=10'
Dasselbe Beispiel in Python Ohne zusätzliche Pakete
Python
import json
from urllib.parse import urlencode
from urllib.request import urlopen

params = urlencode({
    "city": "Hamm",
    "only_available": "true",
    "limit": 10,
})
url = f"https://v49457.1blu.de/api/v1/stations?{params}"
with urlopen(url, timeout=15) as response:
    data = json.load(response)

for station in data["items"]:
    print(station["name"], station["address"]["city"])
    for point in station["charging_points"]:
        price = point["pricing"]["adhoc_price_gross_eur_per_kwh"]
        print(point["evse_id"], point["status"], price)
Dasselbe Beispiel in JavaScript Mit fetch und Fehlerbehandlung
JavaScript
async function ladeStationen() {
  const params = new URLSearchParams({
    city: "Hamm",
    only_available: "true",
    limit: "10",
  });
  const response = await fetch(
    `https://v49457.1blu.de/api/v1/stations?${params}`
  );
  if (!response.ok) {
    throw new Error(`API-Anfrage fehlgeschlagen: ${response.status}`);
  }
  const data = await response.json();
  for (const station of data.items) {
    console.log(station.name, station.charging_points);
  }
}

ladeStationen().catch(console.error);
So ist die Antwort aufgebaut Gekürztes Beispiel mit erfundenen Daten
JSON · Beispielantwort
{
  "count": 1,
  "has_more": false,
  "limit": 10,
  "offset": 0,
  "items": [
    {
      "id": 123,
      "name": "Beispiel-Ladestandort",
      "charging_points": [
        {
          "evse_id": "DE*ABC*E12345*1",
          "status": "available",
          "status_updated_at": null,
          "technical": {
            "max_power_kw": 50,
            "connectors": []
          },
          "pricing": {
            "adhoc_price_gross_eur_per_kwh": 0.49,
            "price_includes_vat": true,
            "tariff_updated_at": null
          }
        }
      ]
    }
  ]
}

Die Beispiele fragen Daten erst ab, wenn du sie selbst ausführst.

Teste deine Anfrage direkt hier

Wähle eine Funktion und fülle die gewünschten Parameter aus. Erst mit „Anfrage senden“ wird die API aufgerufen. Die Tests verwenden denselben Datenbestand und dieselben Limits wie deine Anwendung.

Parameter für deine Anfrage
Deine Anfrage

Der Tester führt ausschließlich lesende GET-Abfragen aus.

Noch keine Anfrage gesendet.

Was möchtest du abrufen?

Öffne eine Funktion für Parameter, Rückgabewerte und ein passendes Beispiel. Die folgenden JSON-Endpunkte beziehen sich auf die Basis-URL oben. Den Kartendienst findest du im Anschluss.

GETLadepunkte suchen/stations

Die Antwort enthält items mit Standorten und ihren Ladepunkten. count zählt die zurückgegebenen Standorte; has_more zeigt an, ob weitere verfügbar sind; limit und offset geben den abgefragten Ausschnitt an.

ParameterBedeutung
city / postal_codeTeil eines Ortsnamens oder genaue Postleitzahl.
lat / lon / radius_kmMittelpunkt in WGS84 und Radius: 0,1–200 km, Standard 10 km. Ergebnisse werden nach Entfernung sortiert.
min_lat / max_lat / min_lon / max_lonAlle vier Werte gemeinsam begrenzen den Kartenausschnitt. Mit zusätzlichem Mittelpunkt wird nach Entfernung sortiert; der Radius entfällt.
only_adhoctrue: nur Standorte mit gemeldeter Ad-hoc-Möglichkeit. Standard false.
only_availabletrue: mindestens ein Ladepunkt ist als frei gemeldet. Standard false.
min_power_kwEin passender Ladepunkt erreicht die angegebene Leistung in kW.
max_price_kwhEin passender Ladepunkt hat einen bekannten Kilowattstundenpreis bis zu diesem Betrag in EUR. Beachte die Hinweise zur Umsatzsteuer unten.
limit / offset1–500 Standorte pro Abfrage, Standard 50. offset beginnt bei 0.
cURL · Ladepunkte suchen
curl --get 'https://v49457.1blu.de/api/v1/stations' \
  --data-urlencode 'lat=51.69685' \
  --data-urlencode 'lon=7.76306' \
  --data-urlencode 'radius_km=10' \
  --data-urlencode 'min_power_kw=50' \
  --data-urlencode 'max_price_kwh=0.59' 
Diese Funktion ausprobieren
GETEinen Standort ansehen/stations/{station_id}

Liefert einen Standort mit Betreiber, Adresse, Koordinaten und allen zugeordneten Ladepunkten.

ParameterBedeutung
station_idInterne numerische ID aus einer Stationsantwort. Ersetze 123 im Beispiel durch eine vorhandene ID. Unbekannte IDs liefern 404.
cURL · Einen Standort ansehen
curl 'https://v49457.1blu.de/api/v1/stations/123'
Diese Funktion ausprobieren
GETEinen einzelnen Ladepunkt abrufen/evse/{evse_id}

Liefert technische Daten, Preisangaben, Status und den zugehörigen Standort.

ParameterBedeutung
evse_idVollständige EVSE-ID aus einer Stationsantwort. Im URL-Pfad URL-kodieren. Die ID im Beispiel ist ein Platzhalter; unbekannte IDs liefern 404.
cURL · Einen einzelnen Ladepunkt abrufen
curl 'https://v49457.1blu.de/api/v1/evse/DE%2AABC%2AE12345%2A1'
Diese Funktion ausprobieren
GETEinen Ort finden/geocode

Liefert eine Liste mit Ortsname, Postleitzahl, Koordinaten und Anzahl hinterlegter Standorte. Die Suche umfasst Orte und PLZ-Gebiete; eine vollständige Straßenadresssuche ist nicht enthalten.

ParameterBedeutung
qStadt, Gemeinde oder Postleitzahl; mindestens 2 Zeichen.
limit1–20 Ergebnisse, Standard 6.
cURL · Einen Ort finden
curl --get 'https://v49457.1blu.de/api/v1/geocode' \
  --data-urlencode 'q=Hamm' \
  --data-urlencode 'limit=6'
Diese Funktion ausprobieren
GETDen Datenbestand abfragen/stats

Zählt gespeicherte Standorte, Ad-hoc-Standorte, Ladepunkte, Ladepunkte mit Preis, als frei gemeldete Ladepunkte und aktive Feeds. Die Antwort wird bis zu 30 Sekunden zwischengespeichert und beschreibt den erfassten Datenbestand.

Für diese Abfrage brauchst du keine Parameter.

cURL · Den Datenbestand abfragen
curl 'https://v49457.1blu.de/api/v1/stats'
Diese Funktion ausprobieren
GETQuellen und Lizenzen nachlesen/sources

Liefert aktive Quellen mit Anbieter, Feedtitel, Angebotslink und Lizenz. Beachte bei einer Weiterverwendung die Bedingungen der jeweiligen Quelle.

Für diese Abfrage brauchst du keine Parameter.

cURL · Quellen und Lizenzen nachlesen
curl 'https://v49457.1blu.de/api/v1/sources'
Diese Funktion ausprobieren

Kartenkacheln für eigene Karten

Zusätzlich zu den JSON-Endpunkten gibt es einen Kartendienst unter derselben Domain. Sein Pfad beginnt direkt mit /tiles/, ohne /api/v1.

GET
HEAD
Eine Kartenkachel abrufen/tiles/{z}/{x}/{y}.png

Ersetzt z durch die Zoomstufe (0–19) und x und y durch die nicht negativen ganzzahligen Kachelkoordinaten. GET liefert ein PNG-Bild; HEAD fragt nur die HTTP-Header ab.

Die Antwort verwendet Cache-Control: public, max-age=2592000, immutable (30 Tage). Ungültige Koordinaten liefern 400; fehlende oder nicht erreichbare Kacheln können weitere Fehlerantworten auslösen. Bei der Kartennutzung ist die Namensnennung der OpenStreetMap-Mitwirkenden erforderlich.

cURL · Kartenkachel speichern
curl 'https://v49457.1blu.de/tiles/6/33/21.png' \
  --output karte.png

Der interaktive Tester oben zeigt JSON-Antworten. Für die PNG-Kacheln kannst du dieses cURL-Beispiel oder deine Kartenbibliothek verwenden.

Alle Datenfelder im Überblick

Die Tabellen erklären die Felder der Antworten. Nicht jeder Betreiber liefert alle Angaben; fehlende Informationen können als null oder leere Listen vorliegen.

Stationssuche und Standort
FeldInhalt
count / limit / offset / has_moreAnzahl der zurückgegebenen Standorte, Seitengröße, Startposition und Hinweis auf weitere Treffer.
data_guarantee / attributionHinweise zur Herkunft und Verwendung der Daten in der Suchantwort.
itemsListe der gefundenen Standorte. Die Einzelabfrage liefert den Standort direkt.
id / external_station_id / nameInterne ID, externe Standortkennung und Name.
operator.id / operator.nameBetreiberkennung und Betreibername.
addressstreet, house_number, postal_code, city und country.
coordinateslatitude und longitude in WGS84.
adhoc_charging_availableGemeldete Ad-hoc-Möglichkeit am Standort.
payment_methods / authentication_methodsVom Betreiber angegebene Bezahl- und Authentifizierungsmethoden.
summarytotal_charging_points und available_charging_points am Standort.
charging_pointsAlle Ladepunkte des Standorts, auch solche, die nicht zu den gesetzten Filtern passen.
static_data_updated_atZeitangabe zur Aktualisierung der Standortdaten.
distance_metersEntfernung zum Suchmittelpunkt, falls lat und lon angegeben wurden.
Ladepunkte und technische Daten
FeldInhalt
evse_id / adhoc_availableEVSE-Kennung und gemeldete Ad-hoc-Möglichkeit am Ladepunkt.
statusavailable, occupied, reserved, out_of_service oder unknown.
status_updated_atZeitpunkt der letzten Statusübernahme in unsere Datenbank; kann fehlen. Er ist nicht zwingend der Zeitpunkt einer Zustandsänderung vor Ort.
status_sourceOptional: provider_name, last_checked_at, last_http_status, last_check_ok und mode (delta oder conditional_feed). Der Quellenabruf ist von der letzten Statusübernahme je Ladepunkt zu unterscheiden.
technical.max_power_kw / technical.current_typeMaximale Ladeleistung in kW und gemeldete Stromart.
technical.connectorsAnschlussangaben aus der Quelle, z. B. connector_type, connector_format, max_power_kw, voltage_v, max_current_a und charging_mode.
stationNur bei GET /evse/{evse_id}: id, external_station_id, name, operator_name, street, postal_code, city, latitude und longitude.
Tarifdaten unter pricing
FeldInhalt
currencyGemeldete Währung; bei fehlender Angabe EUR.
adhoc_price_gross_eur_per_kwh / adhoc_price_eur_per_kwhKilowattstundenpreis nach der Umsatzsteuerbehandlung der API. Beide Felder enthalten in der Regel denselben Betrag.
raw_feed_price_eur_per_kwh / price_includes_vatUrsprünglicher Kilowattstundenpreis und Umsatzsteuerkennzeichnung der Quelle (true, false oder null).
adhoc_price_gross_eur_per_min / adhoc_price_eur_per_minMinutenpreis nach der Umsatzsteuerbehandlung der API.
adhoc_session_fee_eurStartgebühr je Ladevorgang.
adhoc_blocking_fee_eur_per_min / adhoc_blocking_grace_period_minBlockiergebühr je Minute und die dazu gemeldete Karenzzeit.
max_charging_duration_minGemeldete maximale Ladedauer in Minuten.
tariff_name / tariff_rulesTarifname und zusätzliche Tarifregeln aus der Quelle.
tariff_updated_atZeitangabe zur Tarifaktualisierung; kann fehlen.
Ortssuche, Statistik und Quellen
FeldInhalt
GET /geocodeListe mit display_name, short_name, postal_code, lat, lon und station_count.
GET /statsstatus, updated_at, stations_total, stations_adhoc, charging_points_total, charging_points_with_price, charging_points_available und active_feeds.
GET /sourcesplatform, cc_by_4_0_license_url, cc0_1_0_license_url, active_sources_count und sources.
sources[]provider_name, feed_title, offer_id, offer_url und license je Datenquelle.
POST /tokens/registerstatus, token, token_prefix, name, rate_limit_per_minute, message und docs_url. Den Token sicher aufbewahren.

Für Werkzeuge und eigene Clients: OpenAPI-Spezifikation als JSON. Sie enthält die aktuellen Pfade, Parametertypen, Pflichtfelder und Grenzen.

Die Antworten richtig nutzen

Hier findest du die wichtigsten Datenfelder und Hinweise, die dir beim Einbinden helfen.

Standort und Ladepunkte

Der Standort enthält Betreiber, Adresse, Koordinaten sowie Bezahl- und Authentifizierungsmethoden. Unter charging_points findest du die einzelnen Ladepunkte.

evse_id
Kennung des Ladepunkts.
technical
Leistung, Stromart und Anschlüsse.
status
available bedeutet als frei gemeldet. Andere oder unbekannte Zustände sind keine bestätigte Freimeldung.

Preise und Aktualität

Unter pricing stehen bekannte kWh- und Minutenpreise, Start- und Blockiergebühren, Karenzzeit, maximale Ladedauer sowie Tarifname und Regeln.

status_updated_at
Zeitangabe zur Statusaktualisierung.
tariff_updated_at
Zeitangabe zur Tarifaktualisierung.
static_data_updated_at
Zeitangabe zu den Standortdaten.
Was du bei Filtern und fehlenden Daten beachten solltest
  • Leistungs-, Preis- und Verfügbarkeitsfilter müssen gemeinsam von mindestens einem Ladepunkt erfüllt werden. Die Antwort enthält weiterhin alle Ladepunkte des passenden Standorts. Prüfe die einzelnen Ladepunkte, wenn du nur die passenden weiterverarbeiten möchtest.
  • Alle Filter greifen vor der Seiteneinteilung. Mit offset und limit kannst du weitere Treffer abrufen. Solange has_more gleich true ist, gibt es weitere Standorte. count zählt nur die aktuelle Seite.
  • null oder leere Listen stehen für fehlende Angaben. Ein fehlender Preis bedeutet nicht, dass das Laden kostenlos ist.
  • Als netto gekennzeichnete Preise rechnet die API derzeit mit 19 % Umsatzsteuer um. Bei unbekannter Kennzeichnung bleibt der gemeldete Betrag unverändert – auch in den Bruttofeldern. Beachte price_includes_vat und raw_feed_price_eur_per_kwh.
  • Die Aktualität hängt von der Quelle ab. Reservierungen, das Starten von Ladevorgängen und Zahlungen sind über diese API nicht möglich.

Wenn eine Anfrage nicht klappt

404
Standort oder Ladepunkt nicht gefunden.
422
Prüfe die übergebenen Parameter.
429
Anfragelimit erreicht. Warte die in Retry-After angegebene Zeit.