POST api/v{version}/personsBulkQuery

Ruft eine oder mehrere Personen anhand des übergebenen Abfrage-Objektes ab. Sind alle Abfrage-Werte leer, so werden alle Personen zurückgegeben. Sind mehrere Abfrage-Werte gesetzt, so werden alle betreffenden Personen zurückgegeben, die einem oder mehreren Kriterien entsprechen (OR-Verknüpfung).

Request

URI Parameter

Name	Beschreibung	Typ
version		string

Body Parameter

PersonBulkQuery

Name	Beschreibung	Typ
Guids	Optional - Die Guids der zu suchenden Personen	Collection of string
Kundennummern	Optional - Die Kundennummern der zu suchenden Personen	Collection of integer
Nachnamen	Optional - Die Nachnamen der zu suchenden Personen	Collection of string
PLZs	Optional - Die Postleitzahlen der Adresse der zu suchenden Personen	Collection of string
Orte	Optional - Die Orte der Adresse der zu suchenden Personen	Collection of string
Kostentraegernummern	Optional - Die Krankenkassen-Nummern der zu suchenden Personen	Collection of string
MagicLineCustomerIDs	Die CustomerID des Kunden in MagicLine.	Collection of string
ZuletzGeaendertTimestampUTCAb	Optional - Timestamp ab der letzten Erzeugung / Änderung der zu suchenden Personen (in UTC / GMT)	timestamp

Request Format

application/json

Beispiel:

{
  "Guids": [
    "1bc7d5b6-f76d-4bc1-a845-0a0649f79594",
    "5f4b11bb-648e-4e7c-8a52-408134803992"
  ],
  "Kundennummern": null,
  "Nachnamen": null,
  "PLZs": null,
  "Orte": null,
  "Kostentraegernummern": null,
  "MagicLineCustomerIDs": null,
  "ZuletzGeaendertTimestampUTCAb": null
}

Response

Rückgabe-Objekt

PersonListResult

Name	Beschreibung	Typ
ResData	Die Liste der Personen	Collection of Person
Status	Ergebnis des Aufrufs (OK, WARN, ERR)	ResStatus
StatusText	Ergebnis des Aufrufs (OK, WARN, ERR) als Text	string
Reason	Begründung eines Fehler-Ergebnisses	ErrReason
ReasonText	Begründung eines Fehler-Ergebnisses als Text	string
ErrDesc	Fehlerbeschreibung	string
ExText	Erweiterte Informationen zum Fehler	string
ExStack	Call-Stack	string
ResDataTypeName	Typ-Name des Ergebnisses (z. Bsp. "Person" oder "PersonList")	string

Response Format

application/json

Beispiel:

{
  "ResData": [
    {
      "Guid": "5f4b11bb-648e-4e7c-8a52-408134803992",
      "Aktiv": true,
      "Kundennummer": 0,
      "Vorname": "Hermine",
      "Nachname": "Dienstag",
      "Geb_Datum": "1980-04-13T00:00:00",
      "Geschlecht": "w",
      "PLZ": "37284",
      "Ort": "Waldkappel",
      "StrasseNr": "Oberweg 3",
      "Telefon_1": "123456",
      "Telefon_2": "",
      "Mobil": "015146430020",
      "EMail": "hallo@azh-myyolo.de",
      "Versichertennummer": "123456",
      "Kostentraegernummer": "99999901",
      "Kartennummer": "16",
      "ZuletzGeaendertTimestampUTC": "2025-06-27T09:43:02Z",
      "MagicLineCustomerID": "0"
    },
    {
      "Guid": "1bc7d5b6-f76d-4bc1-a845-0a0649f79594",
      "Aktiv": true,
      "Kundennummer": 0,
      "Vorname": "Jennifer",
      "Nachname": "Test",
      "Geb_Datum": "1991-07-02T00:00:00",
      "Geschlecht": null,
      "PLZ": "12133",
      "Ort": "Am Bahnhof",
      "StrasseNr": "89",
      "Telefon_1": "+49 12345678",
      "Telefon_2": "",
      "Mobil": "+49 12345678",
      "EMail": "example123123123123s@email.com",
      "Versichertennummer": null,
      "Kostentraegernummer": null,
      "Kartennummer": "",
      "ZuletzGeaendertTimestampUTC": "2023-05-10T15:04:27Z",
      "MagicLineCustomerID": "0"
    }
  ],
  "Status": 0,
  "StatusText": "OK",
  "Reason": 0,
  "ReasonText": "None",
  "ErrDesc": "",
  "ExText": "",
  "ExStack": "",
  "ResDataTypeName": "PersonList"
}