---
title: "API v2 reference"
description: "Filemonk API v2 (Beta): every resource and endpoint, with request and response examples."
url: https://docs.filemonk.io/v2/api-reference/
api: "API v2 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`. Authenticate with the `X-Auth-Token` header.

## Resources

- [Account](https://docs.filemonk.io/v2/api-reference/account.md) (1 endpoints): The shop the key belongs to, its plan, limits and usage.
- [Analytics](https://docs.filemonk.io/v2/api-reference/analytics.md) (1 endpoints): Order and download counters from the home page.
- [Assets](https://docs.filemonk.io/v2/api-reference/assets.md) (8 endpoints): Files, links and licence-key files in the library.
- [Customers](https://docs.filemonk.io/v2/api-reference/customers.md) (4 endpoints): Buyers Filemonk delivered to, and their email opt-out.
- [Digital Products](https://docs.filemonk.io/v2/api-reference/digital-products.md) (11 endpoints): Shopify products or variants with files attached, their delivery, pre-order and update-email settings.
- [Download Logs](https://docs.filemonk.io/v2/api-reference/download-logs.md) (1 endpoints): Every download, with the order, file and client.
- [Emails](https://docs.filemonk.io/v2/api-reference/emails.md) (1 endpoints): Every email Filemonk sent and how far it got.
- [Exports](https://docs.filemonk.io/v2/api-reference/exports.md) (1 endpoints): CSV exports emailed to the shop.
- [Imports](https://docs.filemonk.io/v2/api-reference/imports.md) (4 endpoints): Bulk CSV imports of historic orders.
- [Licence Tags](https://docs.filemonk.io/v2/api-reference/licence-tags.md) (4 endpoints): Pools of licence keys, by tag.
- [Licences](https://docs.filemonk.io/v2/api-reference/licences.md) (10 endpoints): Licence keys: add, import, check, move and delete.
- [Orders](https://docs.filemonk.io/v2/api-reference/orders.md) (20 endpoints): Orders, their files and downloads, access, licence keys and download emails.
- [Settings](https://docs.filemonk.io/v2/api-reference/settings.md) (8 endpoints): Every setting of the Settings page, read whole and changed by deep-partial PATCH.