---
title: "List orders a file is on"
description: "Which orders and digital products a file is on, as the Files page checks before Delete: the orders that can download it now (newest first, up to 50) and the digital products that deliver it."
url: https://docs.filemonk.io/v2/api-reference/assets/list-orders-a-file-is-on/
api: "API v2 reference"
method: GET
path: "/assets/{id}/linked_orders"
---

# List orders a file is on

`GET https://app.filemonk.io/api/v2/external/assets/{id}/linked_orders`

Which orders and digital products a file is on, as the Files page checks before Delete: the orders that can download it now (newest first, up to 50) and the digital products that deliver it.

**Note:** Read-only. Deleting the file ([`DELETE /assets/:id`](https://docs.filemonk.io/v2/api-reference/assets/delete-a-file/)) takes it away from every order listed here.

## Path parameters

- `id` (string, required)

## Returns

- `id` (string, nullable, required): e.g. `e2b7727e-45ad-42b7-b842-cc4615205b10`
- `name` (string, nullable, required): e.g. `guide.pdf`
- `has_linked_orders` (boolean, nullable, required): e.g. `true`
- `orders_count` (integer, nullable, required): e.g. `1`
- `orders` (array of objects, required)
  - `id` (string, nullable, required): e.g. `3f1c2b8e-5a7d-4e19-9c61-2b8d0f4a7c55`
  - `name` (string, nullable, required): e.g. `#1042`
  - `email` (string, nullable, required): e.g. `buyer@example.com`
  - `created_at` (string, nullable, required): e.g. `2026-10-28T14:02:11Z`
- `digital_products` (array of objects, required)
  - `id` (string, nullable, required): e.g. `7ea3c05d-6f29-42b6-b24f-43260caeaa32`
  - `title` (string, nullable, required): e.g. `Watercolour Course`
  - `variant_title` (any, required)

Rate limit: this call costs 1 point ([rate limits](https://docs.filemonk.io/v2/errors-and-rate-limits/)).

## Example request

```sh
curl "https://app.filemonk.io/api/v2/external/assets/e2b7727e-45ad-42b7-b842-cc4615205b10/linked_orders" \
  -H "X-Auth-Token: $FILEMONK_API_KEY"
```

## 200

Success: the requested resource.

```json
{
  "id": "e2b7727e-45ad-42b7-b842-cc4615205b10",
  "name": "guide.pdf",
  "has_linked_orders": true,
  "orders_count": 1,
  "orders": [
    {
      "id": "3f1c2b8e-5a7d-4e19-9c61-2b8d0f4a7c55",
      "name": "#1042",
      "email": "buyer@example.com",
      "created_at": "2026-10-28T14:02:11Z"
    }
  ],
  "digital_products": [
    {
      "id": "7ea3c05d-6f29-42b6-b24f-43260caeaa32",
      "title": "Watercolour Course",
      "variant_title": null
    }
  ]
}
```

## 401

Missing or invalid API key.

```json
{
  "errors": [
    "Invalid API key"
  ]
}
```

## 404

The resource does not exist for this shop, or the action path is not registered.

```json
{
  "errors": [
    "Order not found: c3d4e5f6-7a8b-4c9d-8e0f-1a2b3c4d5e6f"
  ]
}
```

## 422

The request failed validation, or sent a key the action does not take (`code: "unknown_parameters"` with `unknown` and `accepted`). Nothing was saved.

```json
{
  "errors": [
    "access.download_limit_count must be an integer of at least 0"
  ],
  "field_errors": {
    "access.download_limit_count": [
      "must be an integer of at least 0"
    ]
  }
}
```

## 429

Rate limited. Cost-weighted per API key, shared with API v1: a read costs 1 point, a write 2, 40 points per fixed 60-second window. Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (Unix time the window ends); a 429 adds `Retry-After` (seconds), `retry_after`, `retryable: true` and a `next_step` in the body. A 429 did nothing: wait `retry_after` seconds, then send the same request again. The budget is per key, so every tool or script using the key shares it; prefer one list call with `per_page` over many single reads.

```json
{
  "errors": [
    "You have exceeded the rate limit of 40 points per 60 seconds. Read requests cost 1 point(s) and write requests cost 2 point(s). Please retry after 12 second(s)."
  ],
  "code": "rate_limited",
  "retry_after": 12,
  "error": "Rate limit exceeded",
  "message": "You have exceeded the rate limit of 40 points per 60 seconds. Read requests cost 1 point(s) and write requests cost 2 point(s). Please retry after 12 second(s)."
}
```