diff --git a/README.md b/README.md
index 5f9d8d3..0a9e250 100644
--- a/README.md
+++ b/README.md
@@ -194,6 +194,8 @@ curl -X POST http://localhost:3000/inventory/playfab   -H "Authorization: Bearer
 ```bash
 curl -X POST http://localhost:3000/inventory/playfab/test   -H "Authorization: Bearer <JWT>"   -H "Content-Type: application/json"   -d '{"playfabToken":"XBL3.0 x=<uhs>;<xstsToken>","entityType":"title_player_account","count":50}'
 ```
+* `playfabToken` comes from `POST /auth/callback` in this API (response field `playfabToken`).
+* Use `entityType=master_player_account` to target the master entity. If you want a specific entity id, pass `entityId`. Otherwise the service uses the PlayFabId returned by LoginWithXbox.
 
 ### 10) Captures (screenshots) → `/captures/screenshots`
 ```bash
diff --git a/src/routes/inventory.routes.js b/src/routes/inventory.routes.js
index 9fa7736..3b957ae 100644
--- a/src/routes/inventory.routes.js
+++ b/src/routes/inventory.routes.js
@@ -89,16 +89,19 @@ router.post("/playfab", jwtMiddleware, asyncHandler(async (req, res) => {
  *               playfabToken:
  *                 type: string
  *                 description: PlayFab XSTS token in the form XBL3.0 x={uhs};{token}
+ *                 example: "XBL3.0 x=<uhs>;<xstsToken>"
  *               entityType:
  *                 type: string
  *                 enum: [title_player_account, master_player_account]
  *                 default: title_player_account
+ *                 example: "title_player_account"
  *               entityId:
  *                 type: string
  *                 description: Optional entity id override for the chosen entity type
  *               collectionId:
  *                 type: string
  *                 default: "default"
+ *                 example: "default"
  *               count:
  *                 type: integer
  *                 default: 50