Reason codes

reason_codes is a list of short identifiers explaining why a scan received its recommendation. Codes can be combined; treat the list as an unordered set and as open-ended. New codes may be added over time, so code defensively against unknown codes — never assume the list is exhaustive or in a fixed order.

Categorical codes

Emitted when matching keywords or domains are found.

Code	Meaning
`PROHIBITED_DOMAIN`	A direct link to a domain on Tumban’s prohibited list.
`ADULT_KEYWORDS`	Adult-content keywords detected in profile text.
`ADULT_CONTENT_LINK`	Link to an adult-content platform or service.
`ADULT_SERVICES_KEYWORDS`	Adult-services keywords (escort, in-person services).
`EXTERNAL_ADULT_CONTEXT`	Profile is mentioned on adult sites elsewhere on the web.
`PIRACY_KEYWORDS`	Piracy / unlicensed-streaming keywords detected.
`PIRACY_INDICATORS`	Contextual signals of piracy (IPTV, cracked accounts, shared subscriptions).
`GAMBLING_KEYWORDS`	Gambling / wagering keywords detected.
`GAMBLING_INDICATORS`	Contextual signals of gambling.
`COUNTERFEIT_KEYWORDS`	Counterfeit-goods keywords detected.
`COUNTERFEIT_INDICATORS`	Contextual signals of counterfeit goods.
`ACCOUNT_SHARING_KEYWORDS`	Account-sharing or subscription-sharing keywords detected.

Pattern codes

Emitted when Tumban’s analysis identifies a violation pattern.

Code	Meaning
`SUSPICIOUS_LINK_CHAIN`	Link path leads to a prohibited destination through one or more redirects.
`EVASION_PATTERN`	High proportion of login-gated links combined with promotional language.
`DARK_FUNNEL_PATTERN`	Profile pushes users to private messaging channels with vague promotion.

Exculpatory and clean codes

Code	Meaning
`EXCULPATORY_CONTEXT`	Prohibited keywords appear, but in journalism, education, advocacy, or past-tense framing. The score is suppressed.
`CLEAN_PROFILE`	Tumban’s analysis explicitly cleared the profile.

Content safety codes

Emitted when Tumban’s content classification flagged text or an image.

Code	Meaning
`TEXT_FLAGGED`	Profile text was flagged by the safety classifier.
`IMAGE_FLAGGED`	Profile or banner image was flagged by the safety classifier.
`UNSAFE_CONTENT_BLOCKED`	Upstream safety guardrails refused to analyze the input — treated as a finding, not an error.
`VIOLENCE_CONTENT`	Violence flagged by the safety classifier.
`HATE_CONTENT`	Hate speech flagged by the safety classifier.
`SELF_HARM_CONTENT`	Self-harm content flagged by the safety classifier.

Adjudication codes

Emitted when a follow-up review pass evaluated a borderline score and changed it. A pass that leaves the score unchanged emits no adjudication code.

Code	Meaning
`SECONDARY_REVIEW_CONFIRMED`	Follow-up review pass raised the score, escalating it to at least `review_medium`.
`SECONDARY_REVIEW_DOWNGRADED`	Follow-up review pass downgraded the initial score.

Failure codes

Code	Meaning
`ANALYSIS_ERROR`	Contextual analysis step failed due to an infrastructure error (timeout, network, upstream 5xx). Scores 10 (neutral).
`PARSE_ERROR`	Contextual analysis returned a malformed response. Conservative fallback score 50.
`SCAN_FAILED`	The scan as a whole could not produce a triage report. Webhook payload only — see the `error` field.

New codes may be added over time. Treat unknown codes as informational rather than failing your integration on them.

Get started

Core concepts

API reference

Webhooks

Reference

Categorical codes

Pattern codes

Exculpatory and clean codes

Content safety codes

Adjudication codes

Failure codes

​Categorical codes

​Pattern codes

​Exculpatory and clean codes

​Content safety codes

​Adjudication codes

​Failure codes

Categorical codes

Pattern codes

Exculpatory and clean codes

Content safety codes

Adjudication codes

Failure codes