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

# Get Signed Documents

> Retrieve all signed documents associated with a workflow task

## Endpoint

```
GET /tasks/{task_id}/signed-documents
```

## Authentication

This endpoint requires authentication via API key. Include your API key in the `X-API-Key` header:

```bash theme={null}
X-API-Key: ca_your_api_key_here
```

## Path Parameters

| Parameter | Type    | Required | Description                    |
| --------- | ------- | -------- | ------------------------------ |
| `task_id` | integer | Yes      | Unique identifier for the task |

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://platform.chamelio.ai/tasks/12345/signed-documents" \
    -H "X-API-Key: ca_your_api_key_here"
  ```

  ```python Python theme={null}
  import requests

  task_id = 12345

  url = f"https://platform.chamelio.ai/tasks/{task_id}/signed-documents"
  headers = {
      "X-API-Key": "ca_your_api_key_here"
  }

  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const taskId = 12345;

  const response = await fetch(
    `https://platform.chamelio.ai/tasks/${taskId}/signed-documents`,
    {
      method: 'GET',
      headers: {
        'X-API-Key': 'ca_your_api_key_here'
      }
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

## Response

### Success Response

**Status Code:** `200 OK`

```json theme={null}
{
  "task_id": 12345,
  "workflow_status": "completed",
  "total": 2,
  "documents": [
    {
      "file_id": "document_789",
      "file_name": "signed_contract.pdf",
      "step_id": "sign_step_1",
      "step_name": "Executive Signature",
      "download_url": "https://s3.amazonaws.com/chamelio-files/...",
      "expires_at": "2025-01-20T12:00:00Z"
    },
    {
      "file_id": "document_790",
      "file_name": "signed_nda.pdf",
      "step_id": "sign_step_2",
      "step_name": "NDA Signature",
      "download_url": "https://s3.amazonaws.com/chamelio-files/...",
      "expires_at": "2025-01-20T12:00:00Z"
    }
  ]
}
```

### Response Fields

| Field             | Type    | Description                                       |
| ----------------- | ------- | ------------------------------------------------- |
| `task_id`         | integer | ID of the task                                    |
| `workflow_status` | string  | Current status of the workflow                    |
| `total`           | integer | Total number of signed documents                  |
| `documents`       | array   | List of signed documents associated with the task |

### Document Object Fields

| Field          | Type   | Description                                                |
| -------------- | ------ | ---------------------------------------------------------- |
| `file_id`      | string | Unique identifier of the signed document                   |
| `file_name`    | string | Name of the signed document file                           |
| `step_id`      | string | ID of the workflow step that produced this signed document |
| `step_name`    | string | Display name of the workflow step                          |
| `download_url` | string | Presigned URL to download the signed document              |
| `expires_at`   | string | ISO 8601 timestamp when the download URL expires           |

## Error Responses

### 401 Unauthorized

Returned when authentication fails. See the [authentication errors](/api-reference/introduction#authentication-errors) section for details.

```json theme={null}
{
  "detail": "Invalid API key"
}
```

### 404 Not Found

Returned when the task doesn't exist or you don't have access to it.

```json theme={null}
{
  "detail": "Task not found"
}
```

### 500 Internal Server Error

Returned when the request fails due to a server error.

```json theme={null}
{
  "detail": "Failed to retrieve signed documents"
}
```

## Notes

<Info>
  This endpoint returns signed documents from all signature steps within the task. The `total` field reflects the count of documents in the response.
</Info>

<Warning>
  Presigned download URLs expire after a certain time (indicated by `expires_at` on each document). Download the files before the URLs expire or request new URLs.
</Warning>

<Tip>
  Use the `step_name` field to identify which signature step each document belongs to, especially when a workflow contains multiple signing steps.
</Tip>

## Use Cases

This endpoint is useful for:

* **Post-signing retrieval** - Download fully executed contracts after all parties have signed
* **Document archival** - Save signed documents to long-term storage or a contract management system
* **Audit trails** - Verify which documents were signed as part of a workflow
* **Integration** - Sync signed contracts with ERP, CRM, or document management platforms