RegulioAPI v1

Regulio API v1

REST-API für Plattformen und Partner. Legen Sie Schadenfälle direkt aus Ihrer Software an, fragen Sie Status ab und ergänzen Sie Timeline-Einträge und Dokumente — Ihre Kunden bekommen automatisch eine professionelle Schadenakte mit Pro-Zugang.

Authentifizierung

Jeder Request benötigt einen API-Key im Header. Keys werden auf Anfrage in Ihrem Partner-Account erzeugt und sind dann einmalig im Klartext sichtbar.

X-API-Key: rg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Rate Limit: 100 Requests pro Minute pro Key. Bei Überschreitung: HTTP 429.

Basis-URL

https://regulio.ai

Endpoints

POST/api/v1/cases

Schadenfall anlegen

Legt einen Schadenfall an, erstellt bei Bedarf den Endkunden-Account und versendet eine Einladung per E-Mail. Plan wird automatisch auf Pro gesetzt.

Request body

{
  "title": "Wasserschaden Bad",
  "insurance_type": "Hausrat",
  "case_date": "2026-04-30",
  "description": "Rohrbruch im Erdgeschoss",
  "client_email": "kunde@example.com",
  "client_name": "Max Mustermann"
}

Response (200/201)

{
  "case_id": "8c4a…",
  "case_number": "AB12CD34",
  "client_invite_url": "https://regulio.ai/…"
}
GET/api/v1/cases

Alle eigenen Schadenfälle abrufen

Liefert eine Liste aller Schadenfälle, die unter diesem Partner-Account angelegt wurden (max. 200, neueste zuerst).

Response (200/201)

{
  "cases": [
    {
      "id": "8c4a…",
      "case_number": "AB12CD34",
      "title": "Wasserschaden Bad",
      "insurance_type": "Hausrat",
      "status": "new",
      "case_date": "2026-04-30",
      "created_at": "2026-05-20T08:14:00Z",
      "updated_at": "2026-05-20T08:14:00Z"
    }
  ]
}
GET/api/v1/cases/{id}

Schadenfall-Status abfragen

Detail-Status eines einzelnen Schadenfalls inkl. Aktivitätszählern. 404 wenn nicht vorhanden, 403 wenn der Fall nicht dem Partner gehört.

Response (200/201)

{
  "case_number": "AB12CD34",
  "title": "Wasserschaden Bad",
  "status": "in_progress",
  "insurance_type": "Hausrat",
  "created_at": "2026-05-20T08:14:00Z",
  "timeline_count": 7,
  "documents_count": 3,
  "last_activity": "2026-05-20T10:42:00Z"
}
POST/api/v1/cases/{id}/timeline

Timeline-Eintrag hinzufügen

Hängt einen Notiz/Anruf/E-Mail-Eintrag an die Timeline des Schadenfalls.

Request body

{
  "entry_type": "telefonat",
  "text": "Mit Sachbearbeiter Schmidt gesprochen. Frist 15.06. bestätigt.",
  "contact": "Hr. Schmidt, Allianz"
}

Response (200/201)

{
  "entry_id": "f12b…",
  "created_at": "2026-05-20T10:42:00Z"
}
POST/api/v1/cases/{id}/documents

Dokument hochladen

Lädt eine Datei in den Schadenfall hoch. Content-Type: multipart/form-data. Felder: file (Datei), document_type (z.B. foto, rechnung, gutachten, sonstiges).

Response (200/201)

{
  "document": {
    "id": "9f1c…",
    "doc_name": "rechnung-handwerker.pdf",
    "file_url": "https://…",
    "doc_type": "rechnung",
    "created_at": "2026-05-20T10:50:00Z"
  }
}

Fehler

  • 401 — X-API-Key fehlt oder ist unbekannt/inaktiv
  • 403 — Schadenfall gehört nicht zu diesem Partner
  • 400 — Pflichtfeld fehlt oder ungültiger Body
  • 404 — Schadenfall nicht gefunden
  • 429 — Rate Limit überschritten (100/min)
  • 500 — Server-Fehler — Details im JSON-Body

Fragen oder API-Key beantragen? partner@regulio.ai