---
title: "API v1 reference"
description: "Filemonk API: every resource and endpoint, with request and response examples."
url: https://docs.filemonk.io/api-reference/
api: "API v1 reference"
---

# API v1 reference

API for managing digital products, assets, orders, and downloads in Filemonk.

All endpoints require authentication via the `X-Auth-Token` header. You can
find your API key in the Filemonk app under **Settings &gt; Other &gt; API**.

<h2>Rate Limiting</h2>
All endpoints are rate-limited using a token-bucket algorithm:

- **Bucket size**: 40 points per 60-second window
- **Read requests** (GET): 1 point
- **Write requests** (POST/PATCH/DELETE): 2 points

Rate limit status is returned in response headers:

- `X-RateLimit-Limit`: Maximum points per window
- `X-RateLimit-Remaining`: Points remaining in current window
- `X-RateLimit-Reset`: Unix timestamp when the window resets

When the rate limit is exceeded, a `429 Too Many Requests` response is returned
with a `Retry-After` header indicating how many seconds to wait.

Base URL: `https://app.filemonk.io/api/v1/external`. Authenticate with the `X-Auth-Token` header.

## Resources

- [Orders](https://docs.filemonk.io/api-reference/orders.md) (5 endpoints)
- [Downloads](https://docs.filemonk.io/api-reference/downloads.md) (1 endpoints)
- [Assets](https://docs.filemonk.io/api-reference/assets.md) (6 endpoints)
- [Digital Products](https://docs.filemonk.io/api-reference/digital-products.md) (6 endpoints)
