Vai al contenuto principale
GET
curl
Elenca i casi dell’applicazione, dal più recente al più vecchio per impostazione predefinita. Ogni filtro e ogni opzione di ordinamento disponibili nell’elenco Casi della Console sono esposti come parametri di query, incluso search per la ricerca a testo integrale su soggetto, tag, numero del caso e ID di sessione o transazione collegati. Ogni caso riporta anche il team di appartenenza, il checker indicato per una risoluzione a quattro occhi in attesa, e il country e il portrait del soggetto.

Accesso

Gli endpoint dei casi richiedono una chiave API con accesso completo. Una chiave con accesso limitato riceve 403.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

organization_id
string<uuid>
obbligatorio

UUID dell'organizzazione.

application_id
string<uuid>
obbligatorio

UUID dell'applicazione.

Parametri della query

limit
integer
predefinito:50

Dimensione della pagina. Il valore predefinito è 50.

Intervallo richiesto: x >= 1
offset
integer
predefinito:0

Offset in base zero del primo record.

Intervallo richiesto: x >= 0
status__in
string

Stati separati da virgole da includere, ad es. OPEN,AWAITING_USER.

priority
string

Priorità separate da virgole da includere.

source__in
string

Origini separate da virgole da includere.

blueprint
string<uuid>

Filtra per casi su questo blueprint.

assigned_to
string<uuid>

Filtra per casi assegnati a questo utente.

unassigned
boolean

true per i casi non assegnati, false per i casi assegnati.

tag
string

Filtra per casi associati a questo esatto tag.

Trova corrispondenze per title, case_number, tag, nome/UUID/ID esterno del soggetto, UUID della sessione collegata o UUID della transazione collegata.

date_from
string<date>

Limite inferiore per la data di creazione (incluso).

date_to
string<date>

Limite superiore per la data di creazione (incluso).

due_before
string<date-time>

Limite superiore di due_at.

overdue
boolean

true per restituire solo i casi aperti/in attesa dell'utente scaduti.

ordering
enum<string>
predefinito:-created_at

Ordinamento. due_at ordina i valori nulli per ultimi.

Opzioni disponibili:
created_at,
-created_at,
due_at,
-due_at

Risposta

200 - application/json

Elenco impaginato dei casi.

count
integer

Numero di righe corrispondenti. Esatto fino a 100, limitato a 100 oltre tale soglia per motivi di prestazioni. Fai affidamento sul fatto che next sia null per rilevare l'ultima pagina.

next
string | null

URL assoluto della pagina successiva, o null.

previous
string | null

URL assoluto della pagina precedente, o null.

results
object[]
Ultima modifica il 7 novembre 2026