Optimaite

Parteien

2 Min. LesezeitAktualisiert 26. Mai 2026Also available in English

Parteien repräsentieren alle Kontakte in Ihrer Kanzlei: natürliche Personen, Organisationen und Gerichte. Jede Partei kann mehrere Adressen, Kontaktdaten, Identifikatoren, Bankkonten und Versicherungen haben.

Endpunkte

MethodPathBeschreibung
GET/api/v1/partiesParteien auflisten
POST/api/v1/partiesPartei erstellen
GET/api/v1/parties/{id}Partei abrufen
PUT/api/v1/parties/{id}Partei aktualisieren
DELETE/api/v1/parties/{id}Partei löschen
GET/api/v1/parties/{id}/addressesAdressen auflisten
POST/api/v1/parties/{id}/addressesAdresse erstellen
PUT/api/v1/parties/addresses/{addr_id}Adresse aktualisieren
DELETE/api/v1/parties/addresses/{addr_id}Adresse löschen
GET/api/v1/parties/{id}/contactsKontakte auflisten (Telefon, E-Mail)
POST/api/v1/parties/{id}/contactsKontakt erstellen
GET/api/v1/parties/{id}/identifiersIdentifikatoren auflisten
POST/api/v1/parties/{id}/identifiersIdentifikator erstellen
GET/api/v1/parties/{id}/bank-accountsBankkonten auflisten
POST/api/v1/parties/{id}/bank-accountsBankkonto erstellen
POST/api/v1/parties/conflict-checkInteressenkollision prüfen

Erforderlicher Scope: parties:read für GET-Endpunkte, parties:write für POST/PUT, parties:delete für DELETE.

Das Parteien-Objekt

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "person",
  "display_name": "Dr. Hans Schmidt",
  "first_name": "Hans",
  "last_name": "Schmidt",
  "title": "Dr.",
  "date_of_birth": "1980-03-15",
  "addresses": [
    {
      "id": "addr_01",
      "type": "work",
      "street": "Musterstrasse 42",
      "zip": "10115",
      "city": "Berlin",
      "country": "DE"
    }
  ],
  "contacts": [
    {
      "id": "cnt_01",
      "type": "email",
      "value": "hans.schmidt@example.com"
    }
  ]
}

Parteientypen

TypeBeschreibungWichtige Felder
personNatürliche Personfirst_name, last_name, title, date_of_birth
organizationUnternehmen oder Institutioncompany_name, legal_form, registration_number
courtGericht oder Tribunalcourt_name, court_type, jurisdiction

Interessenkollisionsprüfung

POST /api/v1/parties/conflict-check

Prüft, ob ein Parteiname oder Identifikator mit bestehenden Parteien im Workspace kollidiert:

{
  "query": "Smith",
  "check_identifiers": true
}

Parteien auflisten

GET /api/v1/parties?type=person&search=Smith&limit=50

Query-Parameter

ParameterTypeBeschreibung
cursorstringPagination-Cursor
limitintegerErgebnisse pro Seite (1-100, Standard 50)
typestringFilter: person, organization, court
searchstringSuche nach Name, Firma oder E-Mail

Nächste Schritte

  • Akten -- Parteien mit Akten verknüpfen
  • Dokumente -- Dokumente Parteien zuweisen
Was this helpful?