> ## 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.

# Introduction

> Tumban scans creator profile URLs for prohibited and restricted business activity and returns a triage recommendation.

Tumban analyzes a creator profile URL and returns a structured recommendation
your reviewers can act on. Each scan produces a risk score (0–100), a
confidence level, reason codes, and an evidence index of the URLs and signals
behind the decision.

## How it works

Submit a profile URL. Tumban analyses the profile and its external
footprint, then returns the result either by webhook or by polling.

<Steps>
  <Step title="Submit">
    Send the profile URL to `POST /api/v2/scan/deep` for a full scan, or
    `POST /api/v2/scan/quick` for a faster, cheaper profile-only scan.
    You receive a `scan_id` immediately and the scan begins processing
    in the background.
  </Step>

  <Step title="Wait for the result">
    Tumban delivers the triage report to your `callback_url`, or you can poll
    `GET /api/v2/scans/{scan_id}` until `status` is no longer `processing`.
  </Step>

  <Step title="Triage">
    Use the `recommendation` (`no_flags`, `review_low`, `review_medium`,
    `review_high`) plus the `evidence_index` to route the profile to your
    review queue.
  </Step>
</Steps>

## Where to start

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Mint an API key, submit a scan, and read the result in under five
    minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    API keys for server-to-server use, or session tokens for dashboard
    sessions.
  </Card>

  <Card title="API reference" icon="terminal" href="/api/overview">
    Endpoint-by-endpoint reference, derived from the live handlers.
  </Card>

  <Card title="Webhooks" icon="bell" href="/webhooks/payload">
    Payload format, HMAC verification, and retry behaviour.
  </Card>
</CardGroup>
