---
title: "Screening KYC / AML / Sanctions — Gapup agent-payable C-suite expertise (RISK). Returns a structured, audited deliverabl"
method: POST
path: "/api/v1/call/kyc_screener"
tags: ["compliance", "expertise"]
---

# Screening KYC / AML / Sanctions — Gapup agent-payable C-suite expertise (RISK). Returns a structured, audited deliverabl

`POST /api/v1/call/kyc_screener`

## Request

- Base URL: `https://mcp.gapup.io`
- URL: `https://mcp.gapup.io/api/v1/call/kyc_screener`
- Auth: HTTP bearer

Screening KYC / AML / Sanctions — Gapup agent-payable C-suite expertise (RISK). Returns a structured, audited deliverable. Reference case: Q4 2026 onboarding — 8 entités (UBO chain LLC + SPV offshore), sanctions/PEP/adverse media. Inputs are validated server-side — send the documented case fields.

## Request body

- object
  - `onboardingPacket` object, required
    - `requestId` string
    - `submittedBy` string
    - `submittedAt` string
    - `accountType` 'corporate-banking' | 'private-banking' | 'fund-admin' | 'broker-dealer' | 'payment-institution' | 'other', required
    - `jurisdiction` string, required
  - `entities` object[], required
    - `legalName` string, required
    - `entityType` 'LLC' | 'Ltd' | 'SA' | 'SAS' | 'GmbH' | 'BV' | 'LP' | 'Trust' | 'SPV' | 'Foundation' | 'individual' | 'other', required
    - `jurisdiction` string, required
    - `registrationNumber` string
    - `incorporationDate` string
    - `uboNames` string[]
    - `notes` string
  - `screeningScope` object, required
    - `sanctions` boolean, required
    - `pep` boolean, required
    - `adverseMedia` boolean, required
    - `includeRelatedParties` boolean, required
  - `riskAppetite` 'conservative' | 'standard' | 'liberal', required
  - `async` boolean: If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts.

## Response `200`

Tool result

- object
  - `tool` string
  - `result` object
  - `request_id` string
  - `source` 'rest-api'
  - `ms` number

## Other responses

- `400`: Invalid arguments
- `401`: Unauthorized
- `402`: Payment Required — pay via x402 (USDC on Base) then retry with X-Payment header
- `404`: Tool not found
- `429`: Rate limited
- `500`: Internal error

---

[API](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api.md) · [All operations](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api/revisions/afb9da3b98f4?raw)