Der Trauerfall ist das zentrale Objekt der Public API. Termine, Dokumente und der RIP Tag hängen immer an einem Trauerfall. Du sprichst einen Trauerfall über seine uuid an.
Methode | Pfad | Zweck |
|
| Trauerfälle auflisten |
|
| Einen Trauerfall abrufen |
|
| Trauerfall anlegen |
|
| Trauerfall ändern |
Prozessschritte, Pause, Archivieren und Abschließen beschreibt Prozess, Pause und Abschluss.
Trauerfälle lassen sich über die API nicht löschen. Nicht mehr benötigte Fälle archivierst du.
Das Trauerfall-Objekt
Alle Endpunkte, die einen Trauerfall zurückgeben, liefern dasselbe Objekt.
Grunddaten
Feld | Typ | Beschreibung |
| String | Eindeutige Kennung. Nutze sie für alle Aufrufe. |
| Integer | Interne ID. Taucht als |
| Integer | ID deines Unternehmens |
| String | Vorname der verstorbenen Person |
| String | Nachname |
| String | Vor- und Nachname. Wird automatisch gebildet. |
| String oder | Geburtsdatum, |
| String oder | Sterbedatum, |
| String oder | Interne Notiz. Angehörige sehen sie nicht. |
| String |
|
| String | Angelegt am, |
| String | Zuletzt geändert am |
| Integer | ID des Mitarbeiters, der den Fall angelegt hat |
| String | Name dieses Mitarbeiters |
Zuständigkeit
Feld | Typ | Beschreibung |
| Integer[] | Zugewiesene Mitarbeiter. Der erste ist hauptverantwortlich. |
| Integer oder | Hauptverantwortliche Person (erster Eintrag in |
| String oder | Name dieser Person |
| Integer oder | Standort aus |
Bestattungsart und Prozess
Feld | Typ | Beschreibung |
| Integer oder | Bestattungsart aus |
| String oder | Name der Bestattungsart |
| String oder | Farben der Bestattungsart |
| Array | Prozessschritte der Bestattungsart (siehe unten). Leer ohne Bestattungsart. |
| Integer oder | Erreichter Schritt als Index in |
| Integer |
|
Adressen
Feld | Typ | Beschreibung |
| Array | Adressen des Falls (siehe unten) |
| String oder | Veraltet. Kopie der Abholadresse – nutze |
Link für Angehörige
Feld | Typ | Beschreibung |
| String | Link für Angehörige, zum Beispiel |
| Integer |
|
| Integer |
|
| Integer |
|
| Integer |
|
| String | Standort auf der Karte: |
| Integer | Anzahl der Besuche des Links durch Angehörige |
| String oder | Letzter Besuch, ISO 8601 |
Besuche zählen ohne Cookies: Mehrere Aufrufe desselben Geräts innerhalb von 30 Minuten zählen einmal. Aufrufe angemeldeter Mitarbeiter und Link-Vorschauen in Messengern zählen nicht. POST /cases liefert die beiden Besuchsfelder nicht mit.
RIP Tag
Feld | Typ | Beschreibung |
| String oder | Kennung des verbundenen RIP Tags |
| String oder | Startcode des RIP Tags, zum Beispiel |
| String oder | Letzte Sichtung des RIP Tags, ISO 8601 |
| String oder | Quelle der letzten Sichtung: |
| String oder | Letzte bekannte Position des RIP Tags (immer genau, unabhängig von |
Die vier tag_last_*-Felder sind nur vorhanden, wenn ein RIP Tag verbunden ist. In Listen tauchen sie bei allen Fällen auf (dann mit null), sobald mindestens ein Fall der Liste einen RIP Tag hat. Prüfe also auf „fehlt oder null“. Während einer Pause bleibt die Position auf dem letzten Stand vor der Pause.
Abschluss
Feld | Typ | Beschreibung |
| String oder | Abgeschlossen am. |
| String oder | Koordinaten der letzten Ruhestätte |
| String oder | Adresse oder Beschreibung der letzten Ruhestätte |
| String oder | Notiz zur Ruhestätte, zum Beispiel die Grabnummer. Angehörige sehen sie im Link. Max. 500 Zeichen. |
Prozessschritte (steps[])
Feld | Typ | Beschreibung |
| Integer | ID des Schritts. Brauchst du als |
| String | Name des Schritts |
| Integer | Reihenfolge, beginnend bei |
| Integer |
|
| Integer |
|
| String |
|
| Integer |
|
| Integer | Veraltet, immer |
Adressen (addresses[])
Jeder Fall hat höchstens eine Adresse pro Typ.
Feld | Typ | Beschreibung |
| String |
|
| String oder | Adresse als Text |
| String oder | Koordinaten |
| String oder | Google-Places-ID, falls vorhanden |
Abhol- und Lieferadresse mit Koordinaten nutzt die Automatik, um Schritte bei Ankunft oder Abfahrt weiterzuschalten.
Beispiel
{
"id": 1287,
"uuid": "3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47",
"organization_id": 7,
"deceased_name": "Gisela Neumann",
"first_name": "Gisela",
"last_name": "Neumann",
"date_of_birth": "1938-04-02",
"date_of_death": "2026-11-10",
"burial_type_id": 6,
"pickup_latitude": "52.51627600",
"pickup_longitude": "13.27704100",
"pickup_address": "Seniorenresidenz Am Lindenpark, Parkstraße 8, 14052 Berlin",
"burial_latitude": null,
"burial_longitude": null,
"burial_address": null,
"burial_note": null,
"completed_at": null,
"tag_uuid": "e4a1c9d2-7b3f-4e8a-9d6c-2f5b8a1e0c74",
"tag_startcode": "K7M2-9QXA",
"current_step_index": 1,
"feature_chat_enabled": 1,
"feature_shop_enabled": 0,
"feature_contact_enabled": 1,
"feature_map_enabled": 1,
"map_mode": "exact",
"is_paused": 0,
"branch_id": 3,
"status": "active",
"created_by": 14,
"assigned_to": 15,
"created_at": "2026-11-10 14:32:05",
"updated_at": "2026-11-11 08:15:42",
"notes": "Familie wünscht eine Trauerfeier im kleinen Kreis.",
"burial_type_name": "Feuerbestattung",
"burial_type_color_primary": "#6b2737",
"burial_type_color_secondary": "#c4a0a0",
"creator_first_name": "Jonas",
"creator_last_name": "Berger",
"assigned_first_name": "Lea",
"assigned_last_name": "Hoffmann",
"tag_last_seen_at": "2026-11-11T08:14:57+01:00",
"tag_last_source": "tracker",
"tag_last_latitude": "52.516301",
"tag_last_longitude": "13.277012",
"assigned_user_ids": [15, 18],
"steps": [
{ "id": 41, "name": "RIP Tag angebracht", "position": 0, "has_auto_trigger": 1, "collect_date": 0, "date_mode": "date", "is_public": 1, "advance_on_date": 0 },
{ "id": 42, "name": "Abholung", "position": 1, "has_auto_trigger": 1, "collect_date": 1, "date_mode": "datetime", "is_public": 1, "advance_on_date": 0 },
{ "id": 43, "name": "Im Krematorium", "position": 2, "has_auto_trigger": 1, "collect_date": 0, "date_mode": "date", "is_public": 1, "advance_on_date": 0 },
{ "id": 44, "name": "Trauerfeier", "position": 3, "has_auto_trigger": 0, "collect_date": 1, "date_mode": "datetime", "is_public": 1, "advance_on_date": 0 },
{ "id": 45, "name": "Beisetzung", "position": 4, "has_auto_trigger": 0, "collect_date": 1, "date_mode": "date", "is_public": 1, "advance_on_date": 0 }
],
"addresses": [
{ "type": "pickup", "address": "Seniorenresidenz Am Lindenpark, Parkstraße 8, 14052 Berlin", "latitude": "52.51627600", "longitude": "13.27704100", "place_id": null },
{ "type": "birth", "address": "Görlitz", "latitude": null, "longitude": null, "place_id": null }
],
"link_visit_count": 3,
"link_last_visit_at": "2026-11-11T19:02:11+01:00",
"customer_link_url": "https://de.rip-app.business/t/3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47"
}
Trauerfälle auflisten
GET /cases
Liefert alle Trauerfälle deines Unternehmens, die nicht archiviert sind – auch abgeschlossene. Die neuesten stehen oben. Es gibt keine Paginierung.
Query-Parameter
Parameter | Typ | Pflicht | Beschreibung |
| String | nein |
|
curl "https://de.rip-app.business/api/public/v1/cases" \ -H "Authorization: Bearer $RIP_API_KEY"
curl "https://de.rip-app.business/api/public/v1/cases?status=archived" \ -H "Authorization: Bearer $RIP_API_KEY"
Antwort 200 OK
{
"success": true,
"count": 2,
"data": [
{
"id": 1287,
"uuid": "3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47",
"deceased_name": "Gisela Neumann",
"status": "active",
"current_step_index": 1,
"customer_link_url": "https://de.rip-app.business/t/3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47"
},
{
"id": 1279,
"uuid": "8a3d6f20-1c5e-4b9a-b2d7-4e0f8c1a6d35",
"deceased_name": "Heinrich Albers",
"status": "active",
"current_step_index": 4,
"customer_link_url": "https://de.rip-app.business/t/8a3d6f20-1c5e-4b9a-b2d7-4e0f8c1a6d35"
}
]
}
Jeder Eintrag ist ein vollständiges Trauerfall-Objekt. Das Beispiel ist gekürzt.
Trauerfall abrufen
GET /cases/{uuid}
Liefert einen Trauerfall – archiviert oder nicht.
curl https://de.rip-app.business/api/public/v1/cases/3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47 \ -H "Authorization: Bearer $RIP_API_KEY"
Antwort 200 OK mit dem Trauerfall in data (siehe Beispiel oben).
Code |
| Ursache |
|
| UUID hat ein falsches Format |
|
| UUID unbekannt oder aus einem anderen Unternehmen |
Trauerfall anlegen
POST /cases
Legt einen Trauerfall an. Pflicht sind nur Vor- und Nachname. Alles andere kannst du später mit PATCH ergänzen.
Body-Parameter
Parameter | Typ | Pflicht | Beschreibung |
| String | ja | Vorname, max. 100 Zeichen |
| String | ja | Nachname, max. 100 Zeichen |
| String | nein | Geburtsdatum, |
| String | nein | Sterbedatum, |
| Integer | nein | Bestattungsart aus |
| Integer | nein | Standort aus |
| Integer[] | nein | Mitarbeiter aus |
| String | nein | Interne Notiz |
| Array | nein | Adressen, je Eintrag |
|
| nein | Chat im Link für Angehörige |
|
| nein | Ansprechpartner im Link |
|
| nein | Karte im Link |
|
| nein | Shop im Link. Nur mit Modul Endkundenshop, sonst |
| String | nein |
|
Fehlen die feature_*-Felder oder map_mode, gelten die Voreinstellungen deines Unternehmens unter Einstellungen → Kundenlink.
burial_note, status und current_step_index kannst du beim Anlegen nicht setzen.
curl -X POST https://de.rip-app.business/api/public/v1/cases \
-H "Authorization: Bearer $RIP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"first_name": "Gisela",
"last_name": "Neumann",
"date_of_birth": "1938-04-02",
"date_of_death": "2026-11-10",
"burial_type_id": 6,
"branch_id": 3,
"assigned_user_ids": [15, 18],
"notes": "Familie wünscht eine Trauerfeier im kleinen Kreis.",
"addresses": [
{
"type": "pickup",
"address": "Seniorenresidenz Am Lindenpark, Parkstraße 8, 14052 Berlin",
"latitude": 52.516276,
"longitude": 13.277041
},
{ "type": "birth", "address": "Görlitz" }
],
"feature_chat_enabled": 1,
"map_mode": "exact"
}'
// Node.js 18+
const res = await fetch("https://de.rip-app.business/api/public/v1/cases", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.RIP_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
first_name: "Gisela",
last_name: "Neumann",
date_of_death: "2026-11-10",
burial_type_id: 6,
assigned_user_ids: [15, 18],
}),
});
const body = await res.json();
if (res.status !== 201) throw new Error(`${res.status}: ${body.error}`);
console.log(body.data.uuid, body.data.customer_link_url);
Antwort 201 Created mit dem neuen Trauerfall in data. current_step_index ist null, status ist active.
Code |
| Ursache |
|
| Body fehlt oder ist kein gültiges JSON |
|
|
|
|
| Name zu lang |
|
| Datum im falschen Format (gilt ebenso für das Sterbedatum) |
|
|
|
|
|
|
|
| Eine ID in |
|
|
|
POST /cases legt bei jedem Aufruf einen neuen Fall an. Wiederhole den Request nach einem Timeout erst, wenn du per GET /cases geprüft hast, dass der Fall noch nicht existiert.
Trauerfall ändern
PATCH /cases/{uuid}
Ändert nur die Felder, die du mitschickst. Die Antwort enthält den vollständigen Trauerfall nach der Änderung.
Body-Parameter
Parameter | Typ | Beschreibung |
| String | Darf nicht leer sein, max. 100 Zeichen. |
| String oder |
|
| Integer oder | Bestattungsart wechseln oder entfernen (Folgen siehe unten) |
| Integer oder | Standort setzen oder entfernen |
| Integer[] | Ersetzt alle Zuweisungen. |
| String oder | Interne Notiz. |
| String oder | Öffentliche Notiz zur Ruhestätte. Längere Texte werden nach 500 Zeichen abgeschnitten. Auch nach dem Abschluss änderbar. |
| Array | Setzt die genannten Adresstypen. Ein Eintrag nur mit |
|
| Funktionen im Link für Angehörige |
| String |
|
| String |
|
| Integer oder | Prozessschritt setzen – wie |
| Boolean | Automatik pausieren oder fortsetzen – siehe Prozess, Pause und Abschluss |
paused wird immer allein verarbeitet: Enthält der Body paused, ignoriert die API alle anderen Felder dieses Requests.
curl -X PATCH https://de.rip-app.business/api/public/v1/cases/3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47 \
-H "Authorization: Bearer $RIP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"map_mode": "approximate",
"assigned_user_ids": [15],
"addresses": [
{
"type": "delivery",
"address": "Krematorium Am Wiesengrund, Wiesenweg 5, 13599 Berlin",
"latitude": 52.53318,
"longitude": 13.21452
},
{ "type": "birth" }
]
}'
Hier wird der Standort im Link auf „ungefähr“ gestellt, Murat Yilmaz aus der Zuweisung entfernt, eine Lieferadresse gesetzt und der Geburtsort gelöscht.
Antwort 200 OK mit dem aktualisierten Trauerfall in data.
Bestattungsart wechseln
Wechselst du burial_type_id, passiert Folgendes:
current_step_indexwird aufnullzurückgesetzt – außer du schickst im selben Request einen neuencurrent_step_indexmit.Termine, die an Schritte der alten Bestattungsart gebunden waren, bleiben als freie Termine erhalten. Sie tragen dann den Namen des Schritts als Bezeichnung.
Die Automatik prüft sofort, ob Schritte der neuen Bestattungsart schon erfüllt sind.
Schickst du dieselbe burial_type_id erneut, ändert sich nichts.
Code |
| Ursache |
|
| Kein bekanntes Feld im Body |
|
| Leerer Name |
|
| Falscher Wert für |
|
|
|
|
| UUID unbekannt |
|
|
|
Weitere 400-Fehler entsprechen denen beim Anlegen.