Skip to main content
GET
/
orders
/
{id}
/
downloads
curl -X GET 'https://app.filemonk.com/api/v1/external/orders/a1b2c3d4-e5f6-7890-abcd-ef1234567890/downloads' \
  -H 'X-Auth-Token: fm_api_key_your_key_here'
{
  "order_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "order_name": "#1042",
  "downloads": [
    {
      "id": "d1e2f3a4-b5c6-7890-def0-123456789abc",
      "product_name": "Digital Art Pack",
      "file_name": "artwork-collection.zip",
      "file_type": "application/zip",
      "file_size_bytes": 52428800,
      "download_url": "https://app.filemonk.com/rails/active_storage/blobs/redirect/signed-token/artwork-collection.zip",
      "download_count": 2,
      "download_limit": 5,
      "download_limit_reached": false,
      "expires_at": "2026-04-01T14:30:00Z",
      "download_expired": false,
      "access_revoked": false,
      "is_preorder": false,
      "preorder_available_at": null,
      "preorder_released": true,
      "is_licence_key": false,
      "licence_key": null,
      "downloadable": true
    },
    {
      "id": "e2f3a4b5-c6d7-8901-ef01-23456789abcd",
      "product_name": "Digital Art Pack",
      "file_name": "bonus-brushes.zip",
      "file_type": "application/zip",
      "file_size_bytes": 10485760,
      "download_url": null,
      "download_count": 5,
      "download_limit": 5,
      "download_limit_reached": true,
      "expires_at": "2026-04-01T14:30:00Z",
      "download_expired": false,
      "access_revoked": false,
      "is_preorder": false,
      "preorder_available_at": null,
      "preorder_released": true,
      "is_licence_key": false,
      "licence_key": null,
      "downloadable": false
    },
    {
      "id": "f3a4b5c6-d7e8-9012-f012-3456789abcde",
      "product_name": "Pro Software License",
      "file_name": "Licence Key",
      "file_type": "licence/key",
      "file_size_bytes": 0,
      "download_url": null,
      "download_count": 0,
      "download_limit": null,
      "download_limit_reached": false,
      "expires_at": null,
      "download_expired": false,
      "access_revoked": false,
      "is_preorder": false,
      "preorder_available_at": null,
      "preorder_released": true,
      "is_licence_key": true,
      "licence_key": "ABCD-1234-EFGH-5678",
      "downloadable": true
    }
  ]
}
Returns a flat list of every file associated with an order. Each item includes boolean flags that tell you exactly whether the file can be downloaded right now and why it might be unavailable. You do not need to implement any expiration, limit, or access-revocation logic on your end.

Path parameters

id
string
required
The order’s unique identifier (UUID).

Response

order_id
string
required
The order’s unique identifier.
order_name
string
required
The order name/number, e.g. #1042.
downloads
array
required
Flat list of download objects. Each object represents one file or licence key.

Understanding the downloadable flag

The downloadable field is a convenience flag that combines all the individual status checks:
ConditionFielddownloadable is false when…
Time expirationdownload_expiredThe download window has passed
Count limitdownload_limit_reachedThe customer has used all their downloads
Access revokedaccess_revokedThe order was refunded or cancelled
Preorder pendingpreorder_releasedThe preorder hasn’t been released yet
If you only need to know whether a file is available, check the downloadable field. Use the individual flags when you need to display a specific reason to the user.
curl -X GET 'https://app.filemonk.com/api/v1/external/orders/a1b2c3d4-e5f6-7890-abcd-ef1234567890/downloads' \
  -H 'X-Auth-Token: fm_api_key_your_key_here'
{
  "order_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "order_name": "#1042",
  "downloads": [
    {
      "id": "d1e2f3a4-b5c6-7890-def0-123456789abc",
      "product_name": "Digital Art Pack",
      "file_name": "artwork-collection.zip",
      "file_type": "application/zip",
      "file_size_bytes": 52428800,
      "download_url": "https://app.filemonk.com/rails/active_storage/blobs/redirect/signed-token/artwork-collection.zip",
      "download_count": 2,
      "download_limit": 5,
      "download_limit_reached": false,
      "expires_at": "2026-04-01T14:30:00Z",
      "download_expired": false,
      "access_revoked": false,
      "is_preorder": false,
      "preorder_available_at": null,
      "preorder_released": true,
      "is_licence_key": false,
      "licence_key": null,
      "downloadable": true
    },
    {
      "id": "e2f3a4b5-c6d7-8901-ef01-23456789abcd",
      "product_name": "Digital Art Pack",
      "file_name": "bonus-brushes.zip",
      "file_type": "application/zip",
      "file_size_bytes": 10485760,
      "download_url": null,
      "download_count": 5,
      "download_limit": 5,
      "download_limit_reached": true,
      "expires_at": "2026-04-01T14:30:00Z",
      "download_expired": false,
      "access_revoked": false,
      "is_preorder": false,
      "preorder_available_at": null,
      "preorder_released": true,
      "is_licence_key": false,
      "licence_key": null,
      "downloadable": false
    },
    {
      "id": "f3a4b5c6-d7e8-9012-f012-3456789abcde",
      "product_name": "Pro Software License",
      "file_name": "Licence Key",
      "file_type": "licence/key",
      "file_size_bytes": 0,
      "download_url": null,
      "download_count": 0,
      "download_limit": null,
      "download_limit_reached": false,
      "expires_at": null,
      "download_expired": false,
      "access_revoked": false,
      "is_preorder": false,
      "preorder_available_at": null,
      "preorder_released": true,
      "is_licence_key": true,
      "licence_key": "ABCD-1234-EFGH-5678",
      "downloadable": true
    }
  ]
}