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

# 📥 Descargar

> Descarga los documentos firmados de una tarea concluida de Contractia, en PDF cuando es un único archivo o en ZIP si la tarea incluye varios.

> Permite descargar todos los documentos asociados a una tarea.

<Info>
  Las firmas únicamente estarán disponibles una vez que la tarea se encuentre en estado <Badge color="green">Concluida</Badge>.
</Info>

> Detecta automáticamente cuántos documentos tiene la tarea y prepara la descarga en el formato correspondiente.

<Columns cols={2}>
  <Card title="Descarga individual" type="tip">
    Si la tarea contiene un solo documento, la descarga se realizará en formato PDF.
  </Card>

  <Card title="Descarga múltiple" type="tip">
    Si la tarea contiene varios documentos, se descargará un archivo ZIP con todos los documentos incluidos.
  </Card>
</Columns>

#### <u>Ejemplos:</u>

| **Cantidad de documentos** | Archivo descargado  |
| :------------------------- | :------------------ |
| 1 documento                | `nombreArchivo.pdf` |
| Más de 1 documento         | `nombreArchivo.zip` |

#### <u>Información técnica:</u>

| **Cantidad de documentos** | **Archivo descargado** |
| :------------------------- | :--------------------- |
| Un documento               | `application/pdf`      |
| Varios documentos          | `application/zip`      |

***

## <Badge color="green" size="lg">GET </Badge>➜ /v2/tareas/tarea\_id/documentos

`https://api.contractia.app/v2/tareas/tarea_id/documentos`

<Info>
  Reemplazar `{tarea_id}` por el ID numérico de la tarea deseada.
</Info>

<Note>
  Descarga toda la documentación.
</Note>

### 💻 Ejemplo de implementación

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

  <Tab title="Response JSON">
    ```json theme={null}
    {
      "id": 123,
      "status": "draft"
    }
    ```
  </Tab>
</Tabs>

***

## <Badge color="green" size="lg">GET</Badge> ➜ /v2/tareas/tarea\_id/documentos/documento\_id

`https://api.contractia.app/v2/tareas/tarea_id/documentos/documento_id`

<Info>
  Reemplazar `{tarea_id}` por el ID numérico de la tarea deseada.
</Info>

<Info>
  Reemplazar `{documento_id}` por el ID del documento deseado.
</Info>

<Note>
  Descarga únicamente el documento solicitado.
</Note>

¿Como se el documento id? [➜](/platform/detalle-de-tarea)

### 💻 Ejemplo de implementación

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

  <Tab title="Response JSON">
    ```json theme={null}
    {
      "id": 123,
      "status": "draft"
    }
    ```
  </Tab>
</Tabs>

***