Saltar al contenido principal
GET
curl
Lista los casos de la aplicación, del más reciente al más antiguo por defecto. Todos los filtros y opciones de ordenación disponibles en la lista de casos de la Console se exponen como parámetros de consulta, incluida la búsqueda de texto completo search en el sujeto, las etiquetas, el número de caso y los ID de sesión o de transacción vinculados. Cada caso incluye además su team propietario, el checker asignado a una resolución pendiente según el principio de los cuatro ojos, y el country y el portrait del sujeto.

Acceso

Los endpoints de casos requieren una clave de API con acceso completo. Una clave con acceso restringido recibe un error 403.

Contenido relacionado

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

organization_id
string<uuid>
requerido

UUID de la organización.

application_id
string<uuid>
requerido

UUID de la aplicación.

Parámetros de consulta

limit
integer
predeterminado:50

Tamaño de página. El valor predeterminado es 50.

Rango requerido: x >= 1
offset
integer
predeterminado:0

Desplazamiento, empezando en cero, del primer registro.

Rango requerido: x >= 0
status__in
string

Estados que se incluirán, separados por comas, por ejemplo, OPEN,AWAITING_USER.

priority
string

Prioridades que se incluirán, separadas por comas.

source__in
string

Fuentes que se incluirán, separadas por comas.

blueprint
string<uuid>

Filtrar los casos de este blueprint.

assigned_to
string<uuid>

Filtrar los casos asignados a este usuario.

unassigned
boolean

true para casos sin asignar, false para casos asignados.

tag
string

Filtrar los casos que tienen exactamente esta etiqueta.

Busca coincidencias en el título, case_number, etiqueta, nombre/UUID/ID externo del sujeto, UUID de la sesión vinculada o UUID de la transacción vinculada.

date_from
string<date>

Límite inferior de la fecha de creación (inclusive).

date_to
string<date>

Límite superior de la fecha de creación (inclusive).

due_before
string<date-time>

Límite superior de due_at.

overdue
boolean

true para devolver solo los casos abiertos/en espera del usuario que estén vencidos.

ordering
enum<string>
predeterminado:-created_at

Orden de clasificación. Al ordenar por due_at, los valores nulos van al final.

Opciones disponibles:
created_at,
-created_at,
due_at,
-due_at

Respuesta

200 - application/json

Lista paginada de casos.

count
integer

Número de filas coincidentes. Exacto hasta 100, limitado a 100 a partir de ahí por rendimiento. Para detectar la última página, comprueba que next sea null.

next
string | null

URL absoluta de la página siguiente, o null.

previous
string | null

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

results
object[]
Última modificación el 1 de noviembre de 2026