# Tumban

## Docs

- [Errors](https://docs.tumban.com/api/errors.md): HTTP status codes returned by the Tumban API.
- [Create API key](https://docs.tumban.com/api/keys/create.md): Generate a new API key for programmatic access.
- [List API keys](https://docs.tumban.com/api/keys/list.md): List active API keys for the organization.
- [Revoke API key](https://docs.tumban.com/api/keys/revoke.md): Permanently revoke an API key.
- [Get org settings](https://docs.tumban.com/api/org/get-settings.md): Read your organization's settings.
- [List org scans](https://docs.tumban.com/api/org/list-scans.md): List recent scans across the organization.
- [Update org settings](https://docs.tumban.com/api/org/update-settings.md): Update the organization's default callback URL.
- [Overview](https://docs.tumban.com/api/overview.md): Base URL, authentication, content type, and error envelope.
- [Create batch](https://docs.tumban.com/api/scans/batch.md): Submit multiple profile URLs in a single request.
- [Get batch](https://docs.tumban.com/api/scans/batch-get.md): Fetch a batch's status and per-status counts.
- [Create scan](https://docs.tumban.com/api/scans/create.md): Submit a single profile URL for analysis.
- [Get scan](https://docs.tumban.com/api/scans/get.md): Fetch a scan's full result, including the triage report.
- [Get priority distribution](https://docs.tumban.com/api/usage/priority.md): Recommendation breakdown across the last 30 days.
- [Get scan timeseries](https://docs.tumban.com/api/usage/scans.md): Daily or monthly scan counts for the organization.
- [Get usage totals](https://docs.tumban.com/api/usage/totals.md): Lifetime scan counters for the organization.
- [Get warmer health](https://docs.tumban.com/api/usage/warmer-health.md): Liveness probe for the usage stats pre-aggregator.
- [Rotate webhook secret](https://docs.tumban.com/api/webhook-secret/rotate.md): Generate a new HMAC secret for verifying webhook payloads.
- [Authentication](https://docs.tumban.com/authentication.md): Bearer credentials for the Tumban API — API keys for server use, Clerk JWT for dashboard sessions.
- [Confidence](https://docs.tumban.com/concepts/confidence.md): How confident Tumban is in a recommendation.
- [Coverage](https://docs.tumban.com/concepts/coverage.md): What Tumban actually analyzed during a scan.
- [Evidence index](https://docs.tumban.com/concepts/evidence-index.md): Per-URL evidence the triage report cites.
- [Recommendations and risk scoring](https://docs.tumban.com/concepts/recommendations.md): How a 0–100 risk score maps to one of four recommendation tiers.
- [Scans and batches](https://docs.tumban.com/concepts/scans-and-batches.md): How a scan progresses from submission to a final triage report.
- [Introduction](https://docs.tumban.com/index.md): Tumban scans creator profile URLs against Stripe's prohibited and restricted businesses policy and returns a triage recommendation.
- [Quickstart](https://docs.tumban.com/quickstart.md): Submit your first scan and read back the result.
- [Reason codes](https://docs.tumban.com/reference/reason-codes.md): Machine-readable codes that explain a recommendation.
- [Recommendation values](https://docs.tumban.com/reference/recommendation.md): Allowed values for the recommendation field, with score thresholds.
- [Status values](https://docs.tumban.com/reference/status.md): Allowed values for the scan status field.
- [Delivery and retries](https://docs.tumban.com/webhooks/delivery.md): How Tumban retries webhook delivery and what HTTP statuses it honours.
- [Payload format](https://docs.tumban.com/webhooks/payload.md): The JSON Tumban POSTs to your callback URL when a scan completes.
- [Signature verification](https://docs.tumban.com/webhooks/signatures.md): Confirm a webhook payload was sent by Tumban.

## OpenAPI Specs

- [openapi](https://docs.tumban.com/api-reference/openapi.json)