List orders a file is on

GET/assets/{id}/linked_orders

Costs 1 rate-limit point · Rate limits

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.

Read-only. Deleting the file (DELETE /assets/:id) takes it away from every order listed here.

Also searched asis this file on any orderswho has this filelinked orders for filecheck before deleting file

Path parameters

idstringRequired

Returns

idstring, nullable
Example: e2b7727e-45ad-42b7-b842-cc4615205b10
namestring, nullable
Example: guide.pdf
has_linked_ordersboolean, nullable
Example: true
orders_countinteger, nullable
Example: 1
ordersarray of objects
Show 4 child attributesHide child attributes
- idstring, nullable
  Example: 3f1c2b8e-5a7d-4e19-9c61-2b8d0f4a7c55
- namestring, nullable
  Example: #1042
- emailstring, nullable
  Example: buyer@example.com
- created_atstring, nullable
  Example: 2026-10-28T14:02:11Z
digital_productsarray of objects
Show 3 child attributesHide child attributes
- idstring, nullable
  Example: 7ea3c05d-6f29-42b6-b24f-43260caeaa32
- titlestring, nullable
  Example: Watercolour Course
- variant_titleany

Errors

401

Missing or invalid API key.

404

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

422

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

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.

Every error has the same shape: see Errors.

GET/assets/{id}/linked_orders

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

const res = await fetch("https://app.filemonk.io/api/v2/external/assets/e2b7727e-45ad-42b7-b842-cc4615205b10/linked_orders", {
  headers: {
    "X-Auth-Token": process.env.FILEMONK_API_KEY,
  },
});
const data = await res.json();

import os
import requests

res = requests.get(
    "https://app.filemonk.io/api/v2/external/assets/e2b7727e-45ad-42b7-b842-cc4615205b10/linked_orders",
    headers={"X-Auth-Token": os.environ["FILEMONK_API_KEY"]},
)
data = res.json()

require "net/http"
require "json"

uri = URI("https://app.filemonk.io/api/v2/external/assets/e2b7727e-45ad-42b7-b842-cc4615205b10/linked_orders")
req = Net::HTTP::Get.new(uri, "X-Auth-Token" => ENV["FILEMONK_API_KEY"])
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)

Response

{
  "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
    }
  ]
}

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

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

{
  "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"
    ]
  }
}

{
  "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)."
}