Kontakte verwalten -- Personen, Organisationen und Gerichte -- mit Adressen, Telefonnummern, Bankkonten und Identifikatoren.

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

Method	Path	Beschreibung
`GET`	`/api/v1/parties`	Parteien auflisten
`POST`	`/api/v1/parties`	Partei 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}/addresses`	Adressen auflisten
`POST`	`/api/v1/parties/{id}/addresses`	Adresse 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}/contacts`	Kontakte auflisten (Telefon, E-Mail)
`POST`	`/api/v1/parties/{id}/contacts`	Kontakt erstellen
`GET`	`/api/v1/parties/{id}/identifiers`	Identifikatoren auflisten
`POST`	`/api/v1/parties/{id}/identifiers`	Identifikator erstellen
`GET`	`/api/v1/parties/{id}/bank-accounts`	Bankkonten auflisten
`POST`	`/api/v1/parties/{id}/bank-accounts`	Bankkonto erstellen
`POST`	`/api/v1/parties/conflict-check`	Interessenkollision 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": "Erika Mustermann",
  "first_name": "Erika",
  "last_name": "Mustermann",
  "title": null,
  "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": "erika.mustermann@example.test"
    }
  ]
}

Parteientypen

Type	Beschreibung	Wichtige Felder
`person`	Natürliche Person	first_name, last_name, title, date_of_birth
`organization`	Unternehmen oder Institution	company_name, legal_form, registration_number
`court`	Gericht oder Tribunal	court_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

Parameter	Type	Beschreibung
`cursor`	string	Pagination-Cursor
`limit`	integer	Ergebnisse pro Seite (1-100, Standard 50)
`type`	string	Filter: `person`, `organization`, `court`
`search`	string	Suche nach Name, Firma oder E-Mail

Nächste Schritte

Akten -- Parteien mit Akten verknüpfen
Dokumente -- Dokumente Parteien zuweisen

Parteien