Passer au contenu principal
GET
curl
Liste les dossiers de l’application, les plus récents en premier par défaut. Chaque filtre et option de tri disponible dans la liste des dossiers de la Console est exposé sous forme de paramètre de requête, y compris la recherche en texte intégral search sur le sujet, les tags, le numéro de dossier et les identifiants de session ou de transaction liés. Chaque dossier porte aussi son team propriétaire, le checker désigné d’une résolution à double validation en attente, ainsi que le country et le portrait du sujet.

Accès

Les endpoints des dossiers nécessitent une clé API à accès complet. Une clé à accès restreint reçoit 403.

Pages associées

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

organization_id
string<uuid>
requis

UUID de l'organisation.

application_id
string<uuid>
requis

UUID de l'application.

Paramètres de requête

limit
integer
défaut:50

Taille de page. Vaut 50 par défaut.

Plage requise: x >= 1
offset
integer
défaut:0

Décalage de départ (base zéro) du premier enregistrement.

Plage requise: x >= 0
status__in
string

Statuts à inclure séparés par des virgules, par exemple OPEN,AWAITING_USER.

priority
string

Priorités à inclure séparées par des virgules.

source__in
string

Sources à inclure séparées par des virgules.

blueprint
string<uuid>

Filtrer selon les dossiers associés à ce blueprint.

assigned_to
string<uuid>

Filtrer selon les dossiers assignés à cet utilisateur.

unassigned
boolean

true pour les dossiers non attribués, false pour les dossiers attribués.

tag
string

Filtrer selon les dossiers portant exactement ce tag.

Correspond à title, case_number, tag, nom/UUID/identifiant externe du sujet, UUID de la session liée, ou UUID de la transaction liée.

date_from
string<date>

Limite inférieure de la date de création (incluse).

date_to
string<date>

Limite supérieure de la date de création (incluse).

due_before
string<date-time>

Limite supérieure de due_at.

overdue
boolean

true pour ne renvoyer que les dossiers en retard ouverts/en attente de l'utilisateur.

ordering
enum<string>
défaut:-created_at

Ordre de tri. due_at place les valeurs nulles en dernier.

Options disponibles:
created_at,
-created_at,
due_at,
-due_at

Réponse

200 - application/json

Liste paginée des dossiers.

count
integer

Nombre de lignes correspondantes. Exact jusqu'à 100, plafonné à 100 au-delà pour des raisons de performance. Fiez-vous à la valeur null de next pour détecter la dernière page.

next
string | null

URL absolue de la page suivante, ou null.

previous
string | null

URL absolue de la page précédente, ou null.

results
object[]
Dernière modification le 7 novembre 2026