Skip to main content
The Filemonk API gives you read access to orders and their associated digital downloads. You can use it to build custom integrations, sync download data with external systems, or power your own customer-facing download portals.

​
What you can do

List orders

Search and filter orders by name, email, status, or date range with full pagination support.

Get order downloads

Retrieve a flat list of all files for an order with pre-computed status flags — no filtering logic needed on your end.

​
Base URL

All API requests are made to: 
https://app.filemonk.com/api/v1/external

​
Quick start

1

Get your API key

Open the Filemonk app in your Shopify admin and navigate to Settings > Other > API. Copy the API key displayed there.
Keep your API key secret. Anyone with this key can read your store’s order and download data.
2

Make your first request

Use the X-Auth-Token header to authenticate. Here is an example that lists your most recent orders:
curl -X GET 'https://app.filemonk.com/api/v1/external/orders' \
  -H 'X-Auth-Token: YOUR_API_KEY'
3

Inspect the response

You receive a paginated list of orders:
{
  "orders": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "#1042",
      "email": "customer@example.com",
      "financial_status": "paid",
      "total_price": "29.99",
      "currency": "USD",
      "created_at": "2026-03-01T14:30:00Z",
      "download_count": 3
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_count": 142,
    "total_pages": 6
  }
}

​
Key concepts

​
Pre-computed download status

The downloads endpoint returns a flat array of files with all business logic already resolved. Each download object includes boolean flags like download_expired, download_limit_reached, access_revoked, and a master downloadable flag. You do not need to implement any expiration or limit checking on your side.

​
Pagination

All list endpoints return paginated results. Use the page and per_page query parameters to navigate through results. The response includes a pagination object with total_count and total_pages for building pagination controls.

​
Rate limiting

The API uses a token-bucket rate limiter. Every response includes X-RateLimit-* headers so you can track your usage. See Rate Limiting for details.