Moderation V1
Modmail List V1
List modmail conversations. Requires moderator privileges.
GET /api/v1/moderate/modmail
List modmail conversations. Requires moderator privileges.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
proxy | string | No | Proxy. Optional if stored in Token Vault. |
bearer | string | No | Bearer token. Optional if stored in Token Vault. |
entity | string | No | Subreddit name or fullname (t5_xxxxx). Filters to one sub. Omit for all moderated subs. |
limit | string | No | Number of conversations (default: 25). |
state | string | No | Filter by state: all, new, inprogress, mod, archived, appeals, join_requests, notifications, highlighted, filtered, default. |
Authentication
| Header | Value |
|---|---|
X-RapidAPI-Key | Your RapidAPI key |
X-RapidAPI-Host | red-crawler1.p.rapidapi.com |
Example request
cURL
curl -X GET "https://red-crawler1.p.rapidapi.com/api/v1/moderate/modmail?proxy=<proxy>&bearer=<bearer>&entity=<entity>&limit=25&state=<state>" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com"JavaScript
const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/moderate/modmail?proxy=<proxy>&bearer=<bearer>&entity=<entity>&limit=25&state=<state>", {
method: "GET",
headers: {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
});
const data = await res.json();
console.log(data);Python
import requests
url = "https://red-crawler1.p.rapidapi.com/api/v1/moderate/modmail?proxy=<proxy>&bearer=<bearer>&entity=<entity>&limit=25&state=<state>"
headers = {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.get(url, headers=headers)
print(resp.json())Example response
HTTP 200 — captured from a live call to the gateway.
{
"success": true,
"data": {
"conversations": {},
"messages": {},
"viewerId": "t2_exampleu",
"conversationIds": []
},
"error": null,
"timestamp": "2026-04-29T08:59:01.291961+00:00"
}