sumsub/agent-skills / skills/sumsub-supported-id-documents
sumsub-supported-id-documents
VerifiedQuery AND edit Sumsub's supported identity documents. READ the built-in catalogue (documentsByCountries) — which document types are supported per country, whether they're double-sided, which OCR fields are default vs. available. EDIT a client's own supported-document overrides (idDocSettings.countryMappings) via the global-settings API. TRIGGER when the user asks "which countries / document types support field X", "what fields can I collect for a passport in DEU", "is the ID card double-sided in France", OR wants to change supported documents / toggle a document type / edit collected fields for a country. SKIP for creating levels or questionnaires (use the dedicated skills).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 28.3 KB |
| references/fields-glossary.md | markdown | 17.0 KB |
| scripts/build_country_mappings.pyexecutable | script | 14.7 KB |
| scripts/diff_country_mappings.pyexecutable | script | 3.6 KB |
| scripts/get_entitlements.shexecutable | script | 2.3 KB |
| scripts/get_extension_rules.shexecutable | script | 1.9 KB |
| scripts/get_global_settings.shexecutable | script | 1.7 KB |
| scripts/get_supported_docs.shexecutable | script | 1.8 KB |
| scripts/put_country_mappings.shexecutable | script | 2.2 KB |
| scripts/query_supported_docs.pyexecutable | script | 9.0 KB |
| scripts/recognition_status.pyexecutable | script | 6.1 KB |
| scripts/remove_country_mapping.pyexecutable | script | 2.9 KB |
scripts/get_entitlements.sh
View on GitHub#!/usr/bin/env bash
# GET the client's allowed background-check targets (entitlements) from the
# Sumsub API. Used to check whether paid features like ADVANCED_OCR (required for
# Extra Fields) are enabled before editing.
#
# GET /resources/api/agent/settings/bgCheckTargets
# → { "allowedChecks": { "ADVANCED_OCR": "...", "POA": "...", ... } }
#
# Authenticates via App Token + secret (HMAC-SHA256) per
# https://docs.sumsub.com/reference/authentication.
#
# Usage:
# SUMSUB_APP_TOKEN=sbx:... \
# SUMSUB_SECRET_KEY=... \
# ./get_entitlements.sh # prints the JSON
# ./get_entitlements.sh ADVANCED_OCR # exits 0 if entitlement present, 1 if not
#
# Refuses non-sandbox tokens unless SUMSUB_ALLOW_PROD=1.
set -euo pipefail
: "${SUMSUB_APP_TOKEN:?SUMSUB_APP_TOKEN is required (sandbox App Token, 'sbx:' prefix)}"
: "${SUMSUB_SECRET_KEY:?SUMSUB_SECRET_KEY is required (paired secret key)}"
BASE="${SUMSUB_BASE:-https://api.sumsub.com}"
if [[ "${SUMSUB_APP_TOKEN}" != sbx:* && "${SUMSUB_ALLOW_PROD:-0}" != "1" ]]; then
echo "error: SUMSUB_APP_TOKEN does not look like a sandbox token (expected 'sbx:' prefix)." >&2
echo " Production credentials must not be shared with this skill." >&2
exit 3
fi
METHOD="GET"
PATH_Q="/resources/api/agent/settings/bgCheckTargets"
TS="$(date -u +%s)"
SIG="$(
printf '%s%s%s' "${TS}" "${METHOD}" "${PATH_Q}" \
| openssl dgst -sha256 -hmac "${SUMSUB_SECRET_KEY}" -hex \
| awk '{print $NF}'
)"
BODY_FILE="$(mktemp)"
trap 'rm -f "${BODY_FILE}"' EXIT
HTTP_CODE="$(
curl --compressed -sS -X "${METHOD}" \
-H "X-App-Token: ${SUMSUB_APP_TOKEN}" \
-H "X-App-Access-Ts: ${TS}" \
-H "X-App-Access-Sig: ${SIG}" \
-H "X-Agent-Source-Ver: 1.6.1" \
-H "Accept: application/json" \
-o "${BODY_FILE}" \
-w '%{http_code}' \
"${BASE%/}${PATH_Q}"
)"
if [[ "${HTTP_CODE}" -lt 200 || "${HTTP_CODE}" -ge 300 ]]; then
echo "error: GET ${PATH_Q} returned HTTP ${HTTP_CODE}" >&2
cat "${BODY_FILE}" >&2
exit 4
fi
# Membership-check mode: ./get_entitlements.sh <ENTITLEMENT>
if [[ $# -ge 1 ]]; then
ENTITLEMENT="$1"
if python3 -c "import json,sys; d=json.load(open('${BODY_FILE}')); sys.exit(0 if '${ENTITLEMENT}' in (d.get('allowedChecks') or {}) else 1)"; then
echo "${ENTITLEMENT}: ENABLED"
exit 0
else
echo "${ENTITLEMENT}: NOT enabled"
exit 1
fi
fi
cat "${BODY_FILE}"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |