Zum Hauptinhalt springen
GET
curl
Listet die Fälle der Anwendung auf, standardmäßig die neuesten zuerst. Für jede Filter- und Sortieroption, die in der Fälleliste der Console verfügbar ist, gibt es einen Abfrageparameter. Dazu gehört die Volltextsuche über search, die Betreff, Tags, Fallnummer sowie verknüpfte Sitzungs- und Transaktions-IDs durchsucht. Jeder Fall enthält außerdem das zuständige team, den benannten checker einer ausstehenden Vier-Augen-Entscheidung sowie das country und das portrait der betroffenen Person.

Zugriff

Für die Fall-Endpoints benötigen Sie einen API-Schlüssel mit Vollzugriff. Ein Schlüssel mit eingeschränktem Zugriff erhält 403.

Verwandte Themen

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

organization_id
string<uuid>
erforderlich

UUID der Organisation.

application_id
string<uuid>
erforderlich

Anwendungs-UUID.

Abfrageparameter

limit
integer
Standard:50

Seitengröße. Standardmäßig 50.

Erforderlicher Bereich: x >= 1
offset
integer
Standard:0

Nullbasierter Offset des ersten Datensatzes.

Erforderlicher Bereich: x >= 0
status__in
string

Kommagetrennte Liste der einzuschließenden Status, z. B. OPEN,AWAITING_USER.

priority
string

Kommagetrennte Liste der einzuschließenden Prioritäten.

source__in
string

Kommagetrennte Liste der einzuschließenden Quellen.

blueprint
string<uuid>

Auf Fälle mit diesem Blueprint filtern.

assigned_to
string<uuid>

Auf Fälle filtern, die diesem Benutzer zugewiesen sind.

unassigned
boolean

true für nicht zugewiesene Fälle, false für zugewiesene Fälle.

tag
string

Auf Fälle filtern, die genau diesen Tag aufweisen.

Stimmt mit title, case_number, tag, dem Namen, der UUID oder der externen ID der betroffenen Person sowie der verknüpften Sitzungs-UUID oder Transaktions-UUID überein.

date_from
string<date>

Untergrenze für das Erstellungsdatum (inklusiv).

date_to
string<date>

Obergrenze für das Erstellungsdatum (inklusiv).

due_before
string<date-time>

due_at Obergrenze.

overdue
boolean

true, um nur überfällige Fälle im Status open/awaiting-user zurückzugeben.

ordering
enum<string>
Standard:-created_at

Sortierreihenfolge. due_at sortiert Nullwerte zuletzt.

Verfügbare Optionen:
created_at,
-created_at,
due_at,
-due_at

Antwort

200 - application/json

Paginierte Fallliste.

count
integer

Anzahl der übereinstimmenden Zeilen. Exakt bis 100, darüber aus Performancegründen auf 100 begrenzt. Verlassen Sie sich darauf, dass next null ist, um die letzte Seite zu erkennen.

next
string | null

Absolute URL der nächsten Seite oder null.

previous
string | null

Absolute URL der vorherigen Seite oder null.

results
object[]
Zuletzt geändert am 7. November 2026