> ## Documentation Index
> Fetch the complete documentation index at: https://api.contractia.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 🔎 Buscar

> 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.

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.

## <Badge color="green" size="lg">GET</Badge>➜ /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

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

### 🔁 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

<Tabs>
  <Tab title="cURL (sin filtros)">
    ```bash theme={null}
    curl --location 'https://api.contractia.app/v2/tareas' \
    --header 'Authorization: Bearer {{api_key}}' \
    --header 'user_id: {{user_id}}'
    ```
  </Tab>

  <Tab title="cURL (con filtros)">
    ```bash theme={null}
    curl --location --get '{{base_url}}/v2/tareas' \
    --header 'Authorization: Bearer {{apikey}}' \
    --header 'user_id: {{user_id}}' \
    --data-urlencode 'estado=EN_PROGRESO' 
    ```
  </Tab>

  <Tab title="Response JSON">
    ```json theme={null}
    [
        206746,
        210294,
        1709683
    ]
    ```
  </Tab>
</Tabs>