Get a Subreddit's Moderator Team

Fetch a subreddit's moderator team by name, each moderator's username, id, mod permissions, flair text, and the time they were added.

GET/api/reddit/sub/:name/moderators$0.002 / call

A subreddit's moderator team (Reddit's /r/<name>/about/moderators data): each moderator's username, id, mod permissions, flair text, and when they were added. Returns a moderators list.

When to use this

Reach for this to see who moderates a community before you post, pitch, or appeal a removal: the mod usernames, what each moderator is allowed to do (their mod permissions), and how long each has been on the team. One read.

Path Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Subreddit name (no `r/` prefix)

A subreddit that does not exist returns 404.

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/sub/AskReddit/moderators"

const response = await fetch(
  "https://api.redditapis.com/api/reddit/sub/AskReddit/moderators",
  { headers: { Authorization: "Bearer TOKEN" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.redditapis.com/api/reddit/sub/AskReddit/moderators",
    headers={"Authorization": "Bearer TOKEN"},
)

Response Shape

{
  "moderators": [
    {
      "name": "spez",
      "id": "t2_1w72",
      "mod_permissions": ["all"],
      "flair_text": "Reddit CEO",
      "added_utc": 1201261935,
      "added": "2008-01-25T12:32:15.000Z"
    }
  ]
}

Response Fields

Field	Type	Notes
`name`	string	The moderator's username (no `u/` prefix)
`id`	string	The moderator's account id (the `t2_` fullname suffix)
`mod_permissions`	string[]	What the moderator can do (`all`, `posts`, `mail`, `config`, ...); empty if none
`flair_text`	string \| null	The moderator's flair text on the subreddit (may be `null`)
`added_utc`	number \| null	Unix epoch seconds the moderator was added (may be `null`)
`added`	string \| null	ISO-8601 form of `added_utc` (may be `null`)

Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.