Parteien
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": "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
| 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
Was this helpful?