---
title: "Permission-scoped Ops hub search"
method: GET
path: "/api/admin/ops/search"
tags: ["Admin"]
---

# Permission-scoped Ops hub search

`GET /api/admin/ops/search`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/ops/search`
- Auth: HTTP bearer

Searches fans and moderation reports the caller may use. `fans` needs platform admin (admin or superadmin, the GET /api/admin/users gate) and matches email, name or handle case-insensitively. `reports` needs moderator (moderator, admin or superadmin) and matches a report id prefix or a case-insensitive reason substring. Moderators and ordinary admins never match escalated reports; only superadmins do. A group the caller may not use is omitted rather than returned empty, so a caller with neither tool gets `{}`. Each group is capped at `limit`, newest first; there is no pagination. Reporter and target identities, report details and approval reasons are never returned. Limited to 30 requests per 60 seconds per caller; a limiter outage fails closed. Every response is `Cache-Control: private, no-store`.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Authorized groups only. `{}` when the caller is neither admin nor moderator.

- object
  - `success` true, required
  - `data` object, required
    - `fans` object[]: Present only for platform admins.
      - `id` string, required
      - `handle` string, nullable, required
      - `name` string, nullable, required
      - `email` string, nullable, required
    - `reports` object[]: Present only for moderators and above.
      - `id` string, required
      - `status` 'PENDING' | 'ESCALATED' | 'REVIEWED' | 'RESOLVED' | 'DISMISSED', required
      - `createdAt` string, date-time, required
      - `reason` string, required

## Other responses

- `400`: VALIDATION_ERROR: q missing, blank or longer than 100 characters, or limit not an integer from 1 to 20.
- `401`: UNAUTHORIZED
- `429`: RATE_LIMITED: more than 30 requests in 60 seconds.
- `500`: INTERNAL_ERROR
- `503`: RATE_LIMITER_UNAVAILABLE: the limiter store is unreachable, so the request fails closed.

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/ops/search/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
