Listeneinträge
Business+Lesen, ergänzen, ändern und löschen Sie die Einträge einer Liste, zum Beispiel das Standpersonal eines Ausstellers. Die Werte werden genau wie in den Formularen geprüft (Pflichtfelder, Auswahlwerte, Zahlen, Daten, E-Mail, Längen- und Formatregeln), Sie erhalten also dieselben Meldungen wie eine Person im Formular. Datumswerte im Format JJJJ-MM-TT. Wie das Admin-Formular ist die API nicht an die Ausstellerfrist oder die Höchstzahl an Einträgen gebunden. Jede Änderung wird protokolliert und löst die Webhooks list_entry.created, list_entry.updated oder list_entry.deleted aus.
Endpunkte
/api/v1/list-entries
Einträge einer Liste auflisten (template_id oder template_key ist Pflicht)
/api/v1/list-entries/{id}
Einen Eintrag abrufen
/api/v1/list-entries
Einen Eintrag hinzufügen
/api/v1/list-entries/{id}
Die angegebenen Werte eines Eintrags ändern (die übrigen bleiben)
/api/v1/list-entries/{id}
Einen Eintrag löschen
Abfrageparameter
| Parameter | Beschreibung |
|---|---|
template_id
|
ID der Liste (alternativ template_key) |
template_key
|
Schlüssel der Liste, zusammen mit parent_entity_type |
parent_entity_type
|
event_participant (Standard), event oder contact |
parent_entity_id
|
Nur die Einträge dieses Teilnehmers, Events oder Kontakts |
event_key
|
Nur Teilnehmerlisten: die Einträge aller Teilnehmer dieses Events |
search
|
Suche in den Werten |
Request-Schema
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
template_id
|
integer | Nein | ID der Liste (oder template_key) |
template_key
|
string | Nein | Schlüssel der Liste (Alternative zu template_id) |
parent_entity_type
|
string | Nein | event_participant (Standard), event oder contact |
parent_entity_id
|
integer | Ja | ID des Teilnehmers, Events oder Kontakts, zu dem der Eintrag gehört |
values
|
object | Ja | Die Feldwerte als Objekt: {"field_key": Wert}. Auswahlfelder erwarten den Optionswert, Checkboxen true/false, Daten JJJJ-MM-TT, Anwesenheitsraster eine Liste von Daten. Bei PATCH ändern sich nur die angegebenen Felder. |
Response-Schema
| Feld | Typ |
|---|---|
id
|
integer |
template_id
|
integer |
template_key
|
string |
parent_entity_type
|
string |
parent_entity_id
|
integer |
values
|
object |
created_at
|
string |
updated_at
|
string |
Codebeispiele
curl -X GET "https://ihr-mandant.plandocket.com/api/v1/list-entries?template_key=YOUR_LIST_KEY&parent_entity_id=123" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"<?php
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://ihr-mandant.plandocket.com';
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $baseUrl . '/api/v1/list-entries?template_key=YOUR_LIST_KEY&parent_entity_id=123',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const apiKey = 'YOUR_API_KEY';
const baseUrl = 'https://ihr-mandant.plandocket.com';
const response = await fetch(`${baseUrl}/api/v1/list-entries?template_key=YOUR_LIST_KEY&parent_entity_id=123`, {
method: 'GET',
headers: {
'Authorization': `Bearer ${apiKey}`,
},
});
const data = await response.json();
console.log(data);import requests
api_key = 'YOUR_API_KEY'
base_url = 'https://ihr-mandant.plandocket.com'
headers = {
'Authorization': f'Bearer {api_key}',
}
response = requests.get(f'{base_url}/api/v1/list-entries?template_key=YOUR_LIST_KEY&parent_entity_id=123', headers=headers)
data = response.json()
print(data)Beispiel-Antwort
{
"data": [
{
"id": 1,
"template_id": 1,
"template_key": "string",
"parent_entity_type": "string",
"parent_entity_id": 1,
"values": {},
"created_at": "2026-01-15T10:00:00+01:00",
"updated_at": "2026-01-15T10:00:00+01:00"
}
],
"meta": {
"current_page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}
}