Filtros y ordenación

Filtros

La mayoría de los endpoints de listado aceptan filtros específicos del recurso como parámetros de query. Los filtros de rango usan sufijos entre corchetes:

GET /v1/emails?status=approved
                &created_at[gte]=2026-01-01T00:00:00Z
                &created_at[lt]=2026-02-01T00:00:00Z

Operadores admitidos en campos de fecha y numéricos: gt, gte, lt, lte, más in (lista separada por comas) en todos los campos. Los campos array como to coinciden con filas que contienen el valor (?to=x@y.com). Cada recurso acepta solo los filtros listados en su página bajo Recursos; un filtro desconocido, un campo no ordenable o un valor malformado (un id que no es UUID, un timestamp inválido) se rechaza con 400 validation_failed.

Ordenación

GET /v1/emails?sort=-created_at

Prefijo - para orden descendente. Se pueden separar varias claves por coma (sort=from,-created_at); id es siempre el desempate final. El valor predeterminado es -created_at (más recientes primero). Solo los campos listados en la página de cada recurso bajo Recursos se pueden ordenar — son columnas no nulas, para que la paginación keyset siga siendo exacta.