From bf73eb9b7af2c7ddbc13734891f37fcaab0c9dcc Mon Sep 17 00:00:00 2001
From: evanpelle <evanpelle@gmail.com>
Date: Tue, 7 Apr 2026 17:06:07 -0700
Subject: [PATCH] update clan sessions api documentation

---
 docs/API.md | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/docs/API.md b/docs/API.md
index 16f82297b..b80c67e0b 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -207,10 +207,24 @@ GET https://api.openfront.io/public/clan/:clanTag/sessions
 
 - `start` (optional): ISO 8601 timestamp
 - `end` (optional): ISO 8601 timestamp
+- `page` (optional): Page number, 1-200 (default: 1)
+- `limit` (optional): Results per page, 1-50 (default: 20)
+
+**Response:**
+
+```json
+{
+  "results": [ ... ],
+  "total": 150,
+  "page": 1,
+  "limit": 20
+}
+```
+
+Results are ordered by game start time, newest first.
 
 **Example**
 
 ```bash
-curl https://api.openfront.io/public/clan/UN/sessions?start=2025-11-15T00:00:00Z &
-end=2025-11-18T23:59:59Z
+curl "https://api.openfront.io/public/clan/UN/sessions?start=2025-11-15T00:00:00Z&end=2025-11-18T23:59:59Z&limit=10&page=1"
 ```