---
title: "Check subreddit existence"
method: GET
path: "/v1/tools/validate/subreddit"
tags: ["Validate"]
---

# Check subreddit existence

`GET /v1/tools/validate/subreddit`

Check if a subreddit exists and return basic info (title, subscriber count, NSFW status, post types allowed).

When accountId is provided, uses authenticated Reddit OAuth API with automatic token refresh (recommended). Falls back to Reddit's public JSON API, which may be unreliable from server IPs. Returns exists: false for private, banned, or nonexistent subreddits.

## Query parameters

- `name` string, required
- `accountId` string

## Response `200`

Subreddit lookup result

- union
  - object — Subreddit exists
    - `exists` boolean
    - `subreddit` object
      - `name` string
      - `title` string
      - `description` string
      - `subscribers` integer
      - `isNSFW` boolean
      - `type` 'public' | 'private' | 'restricted'
      - `allowImages` boolean
      - `allowVideos` boolean
  - object — Subreddit not found
    - `exists` boolean
    - `error` string

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)