Ergebnisse Abrufen v1.0
Endpoint Version 1.1
letzte Änderung: 28.10.2025
Der Status und die Ergebnisse einer Analyse können im JSON Format via http GET über folgenden Endpoint abgerufen werden. Hierzu benötigen Sie Ihre eindeutige API-Kennung, die Sie im Rahmen des Onboardings von uns erhalten.
Der GET Endpoint für die Abfrage der Analyseergebnisse lautet:
https://partner:VvSoIe1UEPRpKAm8nPDrDBkEqX1J0uT9@labordatenbank.com/labclinic/stats/view/203/https_json/[API-Kennung]/[Barcode]
Beispiel:
https://partner:VvSoIe1UEPRpKAm8nPDrDBkEqX1J0uT9@labordatenbank.com/labclinic/stats/view/203/https_json/uAx6UyHHP1kU2YUcUQXCGZueNoiyZm3iJD1JIQ3okAOKKR61e0xZqL1uKjXK/ABC1234
Hinweis:
Wenn der [Barcode] parameter der URL weggelassen wird, liefert der Endpoint anstatt eines Arrays mit nur einem Ergebnis ein array mit allen Aufträgen der letzten 30 Tage. Für periodische fetches empfehlen wir daher diesen Abruf.
Der Endpoint liefert ein JSON im folgenden Format (Beispiel):
[
{
"barcode": "OHTEST1",
"status": "done",
"registered": "2025-10-02 00:00:00",
"sample_arrived": "2025-10-02 14:30:00",
"completed": null,
"invalid_msg": null,
"delayed_msg": null,
"results": [
{
"parameter": "TSH",
"value": 14,
"unit": "mIU/l",
"reference": [
{
"color": "red",
"min": null,
"max": 0.27
},
{
"color": "green",
"min": 0.27,
"max": 4.2
},
{
"color": "red",
"min": 4.2,
"max": null
}
],
"comment": null,
"validated": true,
"report_id": 7863
},
...,
{
"parameter": "HbA1ca",
"value": 56,
"unit": "mmol/mol",
"reference": [
{
"color": "green",
"min": null,
"max": 39
}
],
"comment": null,
"validated": true,
"report_id": 7863
}
],
"reports": [
{
"report_id": 7863,
"report_pdf": "https://ldb-uploads-central.s3.eu-central-1.amazonaws.com/labclinic-labordatenbankcom/14291_SC2500005333.pdf"
}
],
"ordered_templates": [
"155"
],
"ordered_parameters": [],
"patient_data": {
"firstname": "Max",
"lastname": "Mustermann",
"birthdate": "1998-02-01",
"gender": "m",
"height": null,
"weight": null,
"street": null,
"zipcode": null,
"place": null,
"country": "DE",
"phone": null,
"email": "max@mustermann.io"
},
"sample_data": {
"sample_taken": "2025-10-02 00:00:00",
"sampletype": "capillary blood"
},
"mail_results": false
}
]
barcode (string)
Eindeutige Kennung des Analyseauftrags im System
status (string)
Aktueller Verarbeitungsstand der Probe.
Mögliche Werte:
– „in progress“: Auftrag ist in Bearbeitung
– „done“: Auftrag ist abgeschlossen
registered (datetime „yyyy-mm-dd hh:mm:ss“)
Zeitpunkt der Registrierung der Anforderung im Laborsystem
sample_arrived (datetime „yyyy-mm-dd hh:mm:ss“ oder null)
Zeitpunkt, zu dem die Probe physisch im Labor eingetroffen ist
completed (datetime „yyyy-mm-dd hh:mm:ss“ oder null)
Zeitpunkt, zu dem die Analyse vollständig abgeschlossen wurde
invalid_msg (string oder null)
Fehlerbeschreibung, falls der Auftrag nicht ausgewertet werden konnte
delayed_msg (string oder null)
Verzögerungsgrund, falls sich Ergebnisse verzögern
results (object array)
Enthält alle Messergebnisse zu Parametern dieses Auftrags (siehe „result Object“)
reports (object array)
Enthält alle PDF Berichte mit Link und ID (siehe „report Object“)
ordered_templates (integer array)
Eine oder mehrere IDs der angeforderten Untersuchungspakete
ordered_parameters (string array)
Ein oder mehrere Kürzel der angeforderten Parameter
patient_data (object)
Stammdaten des Patienten
patient_data.firstname (string oder null)
Vorname des Patienten
patient_data.lastname (string oder null)
Nachname des Patienten
patient_data.birthdate (date „yyyy-mm-dd“)
Geburtsdatum des Patienten
patient_data.gender („m“ / „f“)
Biologisches Geschlecht des Patienten
patient_data.height (decimal oder null)
Körpergröße des patienten in cm
patient_data.weight (decimal oder null)
Körpergewicht des Patienten in kg
patient_data.street (string oder null)
Straße und Hausnummer des Patienten
patient_data.zipcode (string oder null)
Postleitzahl des Patienten
patient_data.place (string oder null)
Wohnort des Patienten
patient_data.country (string oder null)
Ländercode des Wohnsitzes des Patienten (ISO-Standard, z. B. „DE“)
patient_data.phone (string oder null)
Telefonnummer des Patienten
patient_data.email (string oder null)
Email Adresse des Patienten
sample_data (object)
Stammdaten der Probe
sample_data.sample_taken (date „yyyy-mm-dd hh:mm:ss“)
Zeitpunkt der Probenentnahme
sample_data.sample_type („capillary blood“ / „whole blood“)
Probentyp (unterscheidet zwischen Venösem Blut und Kapillarblut)
„result“ Object:
parameter (string)
Kürzel des Messparameters (z. B. TAG, HbA1c). Paramterkürzel abrufbar über Endpoint „Verfügbare Analysen“.
value (decimal)
Gemessener Wert
unit (string)
Einheit in der gemessen wurde
reference (object array)
Enthält Referenzbereiche unter Berücksichtigung von Alter und Geschlecht mit Farbcodierung.
Hinweis: Die meisten Parameter haben nur einen „grünen“ Referenzbereich. Alle werte außerhalb dieses Bereichs liegen außerhalb der Norm und wären als „rot“ zu klassifizieren. Für einige Ausnahmefälle gibt es auch noch „orangene“ Bereiche, welche bedenklich, aber nicht zwingend pathologisch sind.
comment (string oder null)
Parameterspezifischer Kommentar vom Labor
validated (boolean)
Gibt an, ob der angegebene Wert bereits vom Laborarzt validiert und freigegeben wurde
report_id (int oder null)
ID des PDF-Reports in dem dieses Ergebnis zu finden ist (verweist auf Reports array
„reference“ Object:
color (string)
Beurteilungsfarbe
Mögliche Werte:
– „green“
– „orange“
– „red“
min (decimal oder null)
Untere Grenze des Referenzbereichs
max (decimal oder null)
Obere Grenze des Referenzbereichs
„report“ Object
report_id (int)
Eindeutige ID des reports
report_pdf (string)
Link zum Abruf des PDF-Befunds.
ACHTUNG: Links sind nicht dauerhaft gültig. Wir empfehlen die PDFs abzurufen und auf Ihrer Seite abzuspeichern.