Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tumban.com/llms.txt

Use this file to discover all available pages before exploring further.

List recent scans for the organization, sorted newest first. Useful for populating dashboards and review queues. 
GET /api/v2/org/scans
Visibility is org-wide by design — every member of the organization sees every scan, not just the ones they submitted themselves.

​
Query parameters

​
limit
integer
default:"10"
Maximum number of scans to return. Range: 1–50.
​
recommendation
string
Comma-separated list of recommendation values to restrict results to, for example review_high,review_medium. Allowed values: no_flags, review_low, review_medium, review_high. When this parameter is set, only completed scans are returned.

​
Response

​
scans
object[]
required
List of scan summaries.
​
fetched_at
string
required
ISO 8601 UTC timestamp of when the response was generated, with Z suffix.

​
scans[]

​
scan_id
string
required
Use with GET /api/v2/scans/{scan_id} to fetch the full record.
​
profile_url
string
required
The submitted profile URL.
​
status
string
required
See Status values. Includes processing so in-flight scans are visible.
​
submitted_at
string
required
ISO 8601 UTC timestamp.
​
completed_at
string
ISO 8601 UTC timestamp; null if the scan is still processing.
​
recommendation
string
See Recommendation values. null for scans that have not produced a triage report.
​
risk_score
integer
0–100. null for scans without a triage report.
​
confidence
string
low, medium, or high. null for scans without a triage report.

​
Example

curl "https://api.tumban.com/api/v2/org/scans?limit=5&recommendation=review_high,review_medium" \
  -H "Authorization: Bearer sk_xxx"

{
  "scans": [
    {
      "scan_id": "550e8400-e29b-41d4-a716-446655440000",
      "profile_url": "https://creator.example/username",
      "status": "completed",
      "submitted_at": "2026-04-29T12:00:00",
      "completed_at": "2026-04-29T12:01:38",
      "recommendation": "review_high",
      "risk_score": 85,
      "confidence": "high"
    }
  ],
  "fetched_at": "2026-04-29T12:34:56Z"
}

​
Errors

StatusDetail
400Invalid recommendation values: [...] — one or more values in recommendation are not allowed.

​
Using the dashboard

The Home page renders two tables that read from this endpoint:
  • Needs your attention — scans from the last 30 days with recommendation of review_high or review_medium.
  • Recent scans — the eight most recent scans of any status.
The page polls in-flight (processing) scans every five seconds and updates rows in place. Click any non-processing row to open Get scan detail.