# sumsub-supported-id-documents

sumsub-supported-id-documents reads Sumsub's document catalogue and edits document-type settings per country via API.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 813 installs · ★ 7 repo stars
- Author: sumsub
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-supported-id-documents/SKILL.md
- Updated: 2026-10-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/sumsub-supported-id-documents

## What it does

The skill works with two layers: the built-in `documentsByCountries` reference (which document types each country supports, whether they are double-sided, which OCR fields are extracted by default and optionally available) and custom overrides via `idDocSettings.countryMappings`. It answers queries like 'which countries support field X', 'is the ID card double-sided in France', and edits field sets or toggles document types for a given country. The reference is large — around 250 countries and 1350 country/type pairs — so a local Python script returns only the relevant slice.

Writing to the API works via PUT replacement of the entire `countryMappings` map: the skill reads current settings, applies the change, and sends the full map back. Requires an App Token with `manageClientSettings` permission and a secret key, stored in `SUMSUB_APP_TOKEN` and `SUMSUB_SECRET_KEY` variables. Sandbox tokens only.

Includes `build_country_mappings.py` (reads, modifies, assembles the full payload) and `remove_country_mapping.py` (removes one entry from the map). GET `/resources/api/agent/supportedDocs/documentsByCountries` reads the catalogue, GET `/resources/api/agent/globalSettings` fetches the client's current settings, PUT `/resources/api/agent/globalSettings/idDocSettings/countryMappings` replaces the map wholesale.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sumsub-supported-id-documents/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sumsub-supported-id-documents/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sumsub-supported-id-documents/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sumsub-supported-id-documents/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sumsub/agent-skills skills/sumsub-supported-id-documents
```

2. **Manually: put the files in place**
- File: `.github/skills/sumsub-supported-id-documents/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-supported-id-documents
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sumsub-supported-id-documents/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-supported-id-documents/SKILL.md

## When to use it
- find out which document types a country accepts and which fields OCR extracts
- enable or disable a document type for a specific country
- change the set of collected document fields in level settings
- check whether a document is double-sided by Sumsub's standard

## Example prompts
- What OCR fields are available for a passport in Germany?
- Enable ID card collection for France and add the `middleName` field
- Is the driver's licence double-sided by default in Brazil?

## Similar
- [kyc-doc-parse](https://affpapa.org/en/nevibecode/skills/kyc-doc-parse.md) — skill · 1300 installs
- [strale](https://affpapa.org/en/nevibecode/mcp/strale-io-strale.md) — MCP server · 125 installs
- [connect-required-verification-information](https://affpapa.org/en/nevibecode/skills/connect-required-verification-information.md) — skill · 1500 installs
- [citadel-id](https://affpapa.org/en/nevibecode/skills/citadel-id.md) — skill · 184 installs
- [Dabra MCP](https://affpapa.org/en/nevibecode/mcp/dabra-mcp.md) — MCP server · ★ 3 repo stars
- [mcp-api](https://affpapa.org/en/nevibecode/mcp/mcp-api.md) — MCP server · ★ 1 repo stars

From the same set: [sumsub/agent-skills](https://affpapa.org/en/nevibecode/by/sumsub/agent-skills.md) — 28 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
