---
title: "The whole service at a glance. Owner only."
method: GET
path: "/v1/admin/overview"
tags: ["admin"]
---

# The whole service at a glance. Owner only.

`GET /v1/admin/overview`

## Request

- Base URL: `https://api.hookdetector.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hookdetector.com/v1/admin/overview`
- Auth: none declared

Counts across every account: accounts and people; runs (total, last 24 hours, last
7 days, failed in the last 24 hours, in flight); hooks; credits charged (last 24
hours, 7 days, ever) and every balance summed; access requests pending, usable codes
and redemptions; the search provider's credits_left, low and accepting_runs (null when
not read yet); and the running commit. Needs the admin scope and an admin account.
MCP: admin_overview.

## Headers

- `authorization` string, nullable: Bearer hd_... from POST /v1/accounts or POST /v1/keys

## Response `200`

Successful Response

- AdminOverviewOut
  - `accounts` integer, required
  - `users` integer, required
  - `runs` AdminRunCounts, required
    - `total` integer, required
    - `last_24h` integer, required
    - `last_7d` integer, required
    - `failed_24h` integer, required
    - `in_flight` integer, required: queued or running now
  - `hooks` AdminHookCounts, required
    - `total` integer, required
    - `last_24h` integer, required
  - `credits` AdminCredits, required
    - `charged_24h` integer, required: credits charged by runs settled in the last 24 hours
    - `charged_7d` integer, required
    - `charged_total` integer, required
    - `balance_total` integer, required: every account's balance, summed, now
  - `access` AdminAccess, required
    - `pending_requests` integer, required
    - `active_codes` integer, required: not revoked, not expired, not used up
    - `redemptions` integer, required
  - `search` AdminSearch, required
    - `credits_left` integer, nullable, required: our credits with the search provider; null when not read yet
    - `low` boolean, nullable, required
    - `accepting_runs` boolean, required
  - `research` AdminResearch
    - `last_24h` AdminResearchWindow, required
      - `runs_done` integer, required
      - `runs_failed` integer, required
      - `provider_credits` integer, required: Scrape Creators credits the runs spent, failed ones included
      - `provider_credits_per_run` number, nullable, required: provider credits per finished run; null with none
      - `charged` integer, required: credits charged to customers
      - `hooks` integer, required
      - `median_seconds` number, nullable, required: how long a finished run took, median
      - `stage_seconds` object, required: median seconds per stage (searching_instagram, searching_tiktok, judging, transcribing, writing)
      - `failed_by_kind` object, required: failed runs by kind: search, model, orphaned, other
    - `last_7d` AdminResearchWindow, required
      - `runs_done` integer, required
      - `runs_failed` integer, required
      - `provider_credits` integer, required: Scrape Creators credits the runs spent, failed ones included
      - `provider_credits_per_run` number, nullable, required: provider credits per finished run; null with none
      - `charged` integer, required: credits charged to customers
      - `hooks` integer, required
      - `median_seconds` number, nullable, required: how long a finished run took, median
      - `stage_seconds` object, required: median seconds per stage (searching_instagram, searching_tiktok, judging, transcribing, writing)
      - `failed_by_kind` object, required: failed runs by kind: search, model, orphaned, other
  - `commit` string, required

## Other responses

- `401`: missing, invalid, revoked or expired API key (code key_expired)
- `403`: the key lacks the admin scope (insufficient_scope), or its account is not the owner's (admin_required)
- `413`: request body over the size cap
- `422`: invalid input
- `500`: our fault; names the request id

---

[API](https://skmtc.dev/hookdetector/apis/hook-detector.md) · [All operations](https://skmtc.dev/hookdetector/apis/hook-detector/llms.txt) · [OpenAPI document](https://skmtc.dev/hookdetector/apis/hook-detector/revisions/b136a2804d2b?raw)