---
title: "Download Logs"
description: "Every download, with the order, file and client."
url: https://docs.filemonk.io/v2/api-reference/download-logs/
api: "API v2 reference"
---

# Download Logs

Every download, with the order, file and client.

## The download log object

- `id` (string, nullable, required): e.g. `a401ec79-a062-4ab0-96e6-a588931583cc`
- `downloaded_at` (string, nullable, required): e.g. `2026-10-12T19:50:17Z`
- `order` (object, required)
  - `id` (string, nullable, required): e.g. `71e9bb0e-1e22-4513-af29-60aceeeb3755`
  - `name` (string, nullable, required): e.g. `#1058`
- `asset` (object, required)
  - `id` (string, nullable, required): e.g. `96fbe30b-c819-4cb8-9666-814c0c8853f1`
  - `name` (string, nullable, required): e.g. `Beginner's Guide.pdf`
  - `type` (string, nullable, required): e.g. `file`
- `digital_product_id` (string, nullable, required): e.g. `7ea3c05d-6f29-42b6-b24f-43260caeaa32`
- `file` (object, required)
  - `filename` (string, nullable, required): e.g. `Watercolour Basics Workbook.pdf`
  - `content_type` (string, nullable, required): e.g. `application/pdf`
  - `byte_size` (integer, nullable, required): e.g. `116711`
- `licence_tag` (any, required)
- `client` (object, required)
  - `ip_address` (string, nullable, required): e.g. `203.0.113.7`
  - `country_code` (any, required)
  - `user_agent` (string, nullable, required): e.g. `Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) Ap…`
  - `referrer` (string, nullable, required): e.g. `https://app.filemonk.io/orders/71e9bb0e-1e22-4513-af29-60…`
- `cdn_provider` (string, nullable, required): e.g. `cloudflare`

```json
{
  "id": "a401ec79-a062-4ab0-96e6-a588931583cc",
  "downloaded_at": "2026-10-12T19:50:17Z",
  "order": {
    "id": "71e9bb0e-1e22-4513-af29-60aceeeb3755",
    "name": "#1058"
  },
  "asset": {
    "id": "96fbe30b-c819-4cb8-9666-814c0c8853f1",
    "name": "Beginner's Guide.pdf",
    "type": "file"
  },
  "digital_product_id": "7ea3c05d-6f29-42b6-b24f-43260caeaa32",
  "file": {
    "filename": "Watercolour Basics Workbook.pdf",
    "content_type": "application/pdf",
    "byte_size": 116711
  },
  "licence_tag": null,
  "client": {
    "ip_address": "203.0.113.7",
    "country_code": null,
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1",
    "referrer": "https://app.filemonk.io/orders/71e9bb0e-1e22-4513-af29-60aceeeb3755?view_as_merchant=true"
  },
  "cdn_provider": "cloudflare"
}
```

## Endpoints

- `GET /download_logs`: [List download logs](https://docs.filemonk.io/v2/api-reference/download-logs/list-download-logs.md)