---
title: "List a subreddit's post flairs"
method: GET
path: "/composer/reddit/flairs"
tags: ["Composer helpers"]
---

# List a subreddit's post flairs

`GET /composer/reddit/flairs`

## Request

- Base URL: `https://api.misar.io/post`
- URL: `https://api.misar.io/post/composer/reddit/flairs`
- Auth: API key in header `Authorization`

Both `accountId` and `subreddit` are required — omitting either returns an empty `options` list rather than an error. Rate limit: 30 requests/minute.

## Query parameters

- `accountId` string, uuid, required
- `subreddit` string, required

## Response `200`

Flair options.

- OptionsResponse
  - `options` object[], required
    - `value` string, required
    - `label` string, required

## Other responses

- `401`: Missing, malformed, revoked, or invalid API key/session.
- `402`: Plan limit: no active plan (any write; `reason: "no_active_plan"`), a monthly allowance is spent, or the feature is not on the caller's plan. Detect by `code: "plan_limit_exceeded"`.
- `403`: The API key lacks the scope this operation requires (`code: "insufficient_scope"`, `required_scope`).
- `404`: Connected account not found (or not owned by the caller).
- `429`: Per-user, per-route rate limit exceeded for this endpoint.

---

[API](https://skmtc.dev/misarpost/apis/misarpost-api.md) · [All operations](https://skmtc.dev/misarpost/apis/misarpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/misarpost/apis/misarpost-api/revisions/deec26db1305?raw)