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

# List Artifacts

> List your uploaded artifacts

# List Artifacts

List all artifacts you've uploaded.

## Endpoint

```
GET /upload endpoint/artifacts
```

## Query Parameters

| Parameter     | Type    | Required | Description                            |
| ------------- | ------- | -------- | -------------------------------------- |
| `status`      | string  | No       | Filter by status: `active`, `revoked`  |
| `template_id` | string  | No       | Filter by template                     |
| `page`        | integer | No       | Page number (default: 1)               |
| `limit`       | integer | No       | Items per page (default: 50, max: 100) |

## Request

```bash theme={null}
curl -X GET "https://api.docyard.io/v1/upload/artifacts?status=active&limit=20" \
  -H "X-API-Key: dk_live_dist_aaaaaaaa"
```

## Response

```json theme={null}
{
  "artifacts": [
    {
      "id": "art-abc123",
      "template_name": "Insurance Declaration Page",
      "status": "active",
      "locks": {
        "policy_number": "POL-12345678",
        "effective_date": "2026-03-15"
      },
      "threshold": 20,
      "created_at": "2026-03-15T10:30:00Z",
      "retrieval_count": 5
    },
    {
      "id": "art-def456",
      "template_name": "Insurance Declaration Page",
      "status": "revoked",
      "locks": {
        "policy_number": "POL-87654321",
        "effective_date": "2026-03-14"
      },
      "threshold": 20,
      "created_at": "2026-03-14T09:00:00Z",
      "revoked_at": "2026-03-15T15:00:00Z",
      "retrieval_count": 12
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1542,
    "total_pages": 78
  }
}
```

***

## Related Endpoints

* [Get Artifact](/api-reference/artifacts/get)
* [Revoke Artifact](/api-reference/artifacts/revoke)