sumsub/agent-skills

sumsub-check-permissions

Fetch the current tenant's allowed entitlements (BackgroundCheckTarget list).

Trending #3839 First seen May 29, 2026

Installation

$ npx skills add sumsub/agent-skills --skill sumsub-check-permissions

Summary

  • Fetch the current tenant's allowed entitlements (BackgroundCheckTarget list).
  • Returns JSON `{"allowedChecks":{key:label}}` — a map whose keys are the enabled entitlement keys.
  • Called by sumsub-create-level (and other create-* skills) before building a payload to gate entitlement-required features.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from sumsub/agent-skills · top by installs.

npx skills add sumsub/agent-skills

Browse all from sumsub/agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 6
License MIT
Default branch main
Open issues 1
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsBash

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,207 B
  • docs SUMMARY.md 329 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 780 installs

SKILL.md

Check Permissions

Returns the tenant's allowed entitlements so callers can gate features before making any API writes.

Usage

Run the script and parse the result:

bash ${CLAUDE_SKILL_DIR}/scripts/check_permissions.sh

Output: raw Sumsub response body followed by HTTP <code>.

Success (HTTP 200):

{"allowedChecks": {"REUSABLE_KYC_SDK": "Reusable KYC via API/SDK: ...", "VIDEO_IDENT": "Video Identification: ..."}}
HTTP 200

Error (non-200):

{"description":"Unauthorized","errorName":"...","correlationId":"..."}
HTTP 401
  • allowedChecks — map of permission key → human-readable label for all entitlements enabled for this tenant.
  • Permission keys present as keys of allowedChecks are the allowed entitlements.

How callers should use this

If the HTTP status is not 200, stop immediately — show the error body to the user and do not proceed.

After a successful response, check whether the required BackgroundCheckTarget key is present in allowedChecks. If it is not, stop immediately — do not build or POST the payload. Tell the user which entitlement is missing and that they need to contact their CSM or Sumsub Support to get it enabled.

Entitlement → feature mapping (key examples):

Feature Required entitlement
E_KYC docset EKYCTARGET
PROOFOFRESIDENCE docset POA
E_SIGN docset ESIGNTARGET
deviceIntelligenceSettings.enabled: true DEVICE_INTELLIGENCE
QUESTIONNAIRE scoring QUESTIONNAIRE_SCORING
QUESTIONNAIRE attachments QUESTIONNAIRE_ATTACHMENT
NFC chip reading NFC
Video ident sessions VIDEO_IDENT
Reusable KYC via SDK REUSABLEKYCSDK
Known face search KNOWNFACESEARCH
AML / watchlist step WATCHLISTS