Saltar al contingut principal
GET
curl
Llista els casos de l’aplicació, del més recent al més antic per defecte. Cada filtre i opció d’ordenació disponible a la llista de casos de la Console s’exposa com a paràmetre de consulta, inclosa la cerca de text complet search en l’assumpte, les etiquetes, el número de cas i els identificadors de sessió o transacció enllaçats. Cada cas també inclou el seu team propietari, el checker designat d’una resolució pendent segons el principi dels quatre ulls, i el country i el portrait del subjecte.

Accés

Els endpoints dels casos requereixen una clau d’API amb accés complet. Una clau amb accés restringit rep 403.

Relacionats

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

organization_id
string<uuid>
requerit

UUID de l'organització.

application_id
string<uuid>
requerit

UUID de l'aplicació.

Paràmetres de consulta

limit
integer
predeterminat:50

Mida de la pàgina. Per defecte és 50.

Rang requerit: x >= 1
offset
integer
predeterminat:0

Desplaçament basat en zero del primer registre.

Rang requerit: x >= 0
status__in
string

Estats separats per comes que cal incloure, p. ex. OPEN,AWAITING_USER.

priority
string

Prioritats separades per comes que cal incloure.

source__in
string

Fonts separades per comes que cal incloure.

blueprint
string<uuid>

Filtra pels casos d'aquest blueprint.

assigned_to
string<uuid>

Filtra pels casos assignats a aquest usuari.

unassigned
boolean

true per a casos no assignats, false per a casos assignats.

tag
string

Filtra pels casos que tinguin exactament aquesta etiqueta.

Coincideix amb title, case_number, tag, nom/UUID/ID extern del subjecte, UUID de la sessió enllaçada o UUID de la transacció enllaçada.

date_from
string<date>

Límit inferior de la data de creació (inclusiu).

date_to
string<date>

Límit superior de la data de creació (inclusiu).

due_before
string<date-time>

Límit superior de due_at.

overdue
boolean

true per retornar només els casos vençuts en estat obert o en espera de l'usuari.

ordering
enum<string>
predeterminat:-created_at

Criteri d'ordenació. due_at situa els valors nuls al final.

Opcions disponibles:
created_at,
-created_at,
due_at,
-due_at

Resposta

200 - application/json

Llista paginada de casos.

count
integer

Nombre de files coincidents. Exacte fins a 100, limitat a 100 a partir d'aquí per motius de rendiment. Fes servir el fet que next sigui null per detectar l'última pàgina.

next
string | null

URL absoluta de la pàgina següent, o null.

previous
string | null

URL absoluta de la pàgina anterior, o null.

results
object[]
Darrera modificació el 7 de novembre del 2026