Reference

API v2 reference

Filemonk's action-driven, AI-native external API for digital product delivery: orders and their downloads, files (assets), digital products, licence keys, customers, settings and the account. Every action is self-describing (description, aliases, notes, JSON request schema) and also reachable via the /help manifest, skill.md and llms.txt, and through the MCP server (search, execute_read, execute_write). Lists take page (1-based) and per_page (default 50, max 200) and answer { "data": [...], "meta": { "total_count", "page", "per_page", "total_pages" } }. Public beta: actions and schemas may change before GA. All endpoints require the X-Auth-Token API key (or the same key as a Bearer token).

Base URL

https://app.filemonk.io/api/v2/external

Authentication

Send the store's API key in the X-Auth-Token header on every request. How to get a key

Rate limits

A read costs 1 point and a write 2. Rate limits and errors

Resources

Account1 endpoint Analytics1 endpoint Assets8 endpoints Customers4 endpoints Digital Products11 endpoints Download Logs1 endpoint Emails1 endpoint Exports1 endpoint Imports4 endpoints Licence Tags4 endpoints Licences10 endpoints Orders20 endpoints Settings8 endpoints

Your first request

curl "https://app.filemonk.io/api/v2/external/account" \
  -H "X-Auth-Token: $FILEMONK_API_KEY"

const res = await fetch("https://app.filemonk.io/api/v2/external/account", {
  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/account",
    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/account")
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)

Every error looks like this

See Errors.

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