# sumsub-api-generic

Finds and tests Sumsub API endpoints using an OpenAPI specification. Designed for developer tasks not handled by dedicated workflow skills.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 7
- 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-api-generic/SKILL.md
- Updated: 2026-10-02
- HTML: https://affpapa.org/en/nevibecode/skills/sumsub-api-generic

## What it does

This skill handles calls against `api.sumsub.com` when specialized modules like questionnaire or level builders do not fit. It fetches the official OpenAPI 3.0.1 specification and caches it for 24 hours. The agent avoids path guessing by checking routes through `find_endpoint.py` and reading schemas with `show_endpoint.py`.

Calls go through `sumsub_curl.sh`, which generates an HMAC-SHA256 signature for each payload. The script strictly rejects production credentials and requires sandbox tokens starting with `sbx:`. Path parameters must be resolved before signing, and the agent asks for confirmation before sending destructive write actions.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sumsub/agent-skills sumsub-api-generic
```

2. **Manually: put the files in place**
- File: `.github/skills/sumsub-api-generic/SKILL.md`

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-api-generic
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-api-generic -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-api-generic/SKILL.md

## When to use it
- find matching endpoints in the OpenAPI schema without guessing paths
- inspect request payloads and response shapes for Sumsub routes
- sign requests using HMAC-SHA256 and sandbox App Tokens
- fetch applicant verification states and review AML screening hits

## Example prompts
- Find the Sumsub API endpoint for attaching tags to an applicant
- Inspect the request body schema for updating applicant records
- Send a signed sandbox request to fetch AML hits for applicant sbx_test

## Similar
- [inngest-api](https://affpapa.org/en/nevibecode/skills/inngest-api.md) — skill · 783 installs
- [api-recon-and-docs](https://affpapa.org/en/nevibecode/skills/api-recon-and-docs.md) — skill · 3800 installs
- [pipefy-api-fallback](https://affpapa.org/en/nevibecode/skills/pipefy-api-fallback.md) — skill · 673 installs
- [api-smoke-testing](https://affpapa.org/en/nevibecode/skills/api-smoke-testing.md) — skill · 495 installs
- [api-design-patterns](https://affpapa.org/en/nevibecode/skills/api-design-patterns.md) — skill · 936 installs
- [sap-api-style](https://affpapa.org/en/nevibecode/skills/sap-api-style.md) — skill · 785 installs

From the same set: [sumsub/agent-skills](https://affpapa.org/en/nevibecode/by/sumsub/agent-skills.md) — 25 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