🔎 Buscar - Contractia API

Lista los IDs de tareas del tenant con filtros opcionales por fecha de creación o modificación, estado, creador y referencia desde la API de Contractia.

GET➜ /v2/tareas

https://api.contractia.app/v2/tareas

🧾 Parámetros del cuerpo - opcionales-

Parámetro	Tipo	Formato / Ejemplo	Descripción
`fecha_creacion`	string	`2025-09-01/gte_2025-04-16`	Devuelve solo tareas creadas en esa fecha / Devuelve tareas creadas en esa fecha o después.
`fecha_modificacion`	string	`2025-09-10/lt_2025-09-10`	Devuelve tareas modificadas en esa fecha / Devuelve tareas modificadas antes de esa fecha.
`estado`	string	`EN_PROGRESO`	Filtra por estado de la tarea.
`de`	string	`juanperez@dominio.com`	Filtra por creador de la tarea.
`referencia`	string	`Afiliación 12345`	Filtra por referencia asociada a la tarea.

ℹ️ En búsquedas por fecha (‘fecha_creacion’ y ‘fecha_modificacion’) se puede usar un prefijo para filtrar intervalos:

‘gt’ → mayor que

‘gte’ → mayor o igual que

‘lt’ → menor que

‘lte’ → menor o igual que

ℹ️ En búsquedas por estado las opciones son:

EN_PROGRESO

FIRMA_ACEPTADA

FIRMA_RECHAZADA

VENCIDA

CARGA_DE_DATOS

FALLIDA

CANCELADA

BORRADOR

Si no se especifica ningún parámetro, se devuelven todas las tareas activas del tenant.

🔁 Respuestas posibles

Código	Descripción
`200 OK`	Devuelve la lista de IDs de tareas.
`400 Bad Request`	Algún parámetro es inválido.
`403 Forbidden`	`"Acceso denegado"` o `"Tenant no encontrado"`.
`404 Not Found`	No existen tareas para el tenant o filtros aplicados.
`500 Internal Server Error`	Error inesperado al procesar la solicitud.

💻 Ejemplo de implementación

cURL (sin filtros)
cURL (con filtros)
Response JSON

curl --location 'https://api.contractia.app/v2/tareas' \
--header 'Authorization: Bearer {{api_key}}' \
--header 'user_id: {{user_id}}'

curl --location --get '{{base_url}}/v2/tareas' \
--header 'Authorization: Bearer {{apikey}}' \
--header 'user_id: {{user_id}}' \
--data-urlencode 'estado=EN_PROGRESO' 