---
title: "PitfallDB statistics"
method: GET
path: "/api/pitfalldb/stats"
tags: ["PitfallDB"]
---

# PitfallDB statistics

`GET /api/pitfalldb/stats`

## Request

- Base URL: `https://plith.ai`
- URL: `https://plith.ai/api/pitfalldb/stats`
- Auth: none required

Returns aggregate PitfallDB statistics: total visible pitfalls, total reports, top task types by volume, and recent activity. FREE.

## Response `200`

Database statistics

- object
  - `total_pitfalls` integer: Total pitfalls meeting the visibility threshold.
  - `total_reports` integer: Total reports submitted across all orgs.
  - `top_task_types` object[]: Up to 10 task types ranked by report volume.
    - `task_type` string
    - `report_count` integer
  - `recent_activity` object
    - `reports_last_7_days` integer
  - `cross_product` string
  - `request_id` string
  - `credits_used` integer
  - `credits_remaining` integer
  - `fallback_behavior` string

## Other responses

- `401`: Invalid or missing API key
- `500`: Internal server error

---

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