diff --git a/README.md b/README.md
index 8347d4e..bd236f3 100644
--- a/README.md
+++ b/README.md
@@ -127,7 +127,7 @@ Returns detailed information about the pull request including:
     "workspace": "PROJ",  // Required - your project key
     "repository": "my-repo",
     "state": "OPEN",  // Optional: OPEN, MERGED, DECLINED, ALL (default: OPEN)
-    "author": "username",  // Optional: filter by author
+    "author": "username",  // Optional: filter by author (see note below)
     "limit": 25,  // Optional: max results per page (default: 25)
     "start": 0  // Optional: pagination start index (default: 0)
   }
@@ -139,6 +139,10 @@ Returns a paginated list of pull requests with:
 - Total count of matching PRs
 - Pagination info (has_more, next_start)
 
+**Note on Author Filter:**
+- For Bitbucket Cloud: Use the username (e.g., "johndoe")
+- For Bitbucket Server: Use the full email address (e.g., "john.doe@company.com")
+
 ## Development
 
 - `npm run dev` - Watch mode for development