---
title: "Hand off a Sumsub share token"
method: POST
path: "/api/fma/v1/kyc/reuse-share-token"
tags: ["Managed Custody KYC"]
---

# Hand off a Sumsub share token

`POST /api/fma/v1/kyc/reuse-share-token`

Submits a single-use Sumsub share token minted in your tenant for UR's clientId. UR copies the applicant into its own Sumsub tenant, validates the copied data, and returns a conclusive verdict synchronously; UR does not re-run the KYC checks. Requires an onboarding session created by create-account and a GREEN applicant in your tenant. The envelope code is authoritative: passed maps to 0, incomplete to 20004, and terminal verdicts to eligibility codes 30010 to 30012.

## Headers

- `X-Ur-Id` string
- `X-External-User-Id` string
- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string, required

## Request body

- KycReuseShareTokenRequest
  - `shareToken` string, required — Single-use Sumsub share token minted in your tenant with forClientId set to UR's clientId, valid for about 20 minutes. Mint a fresh token for every handoff attempt.

## Response `200`

Business result envelope. code 0 means success; business rejections return HTTP 200 with a non-zero code.

- KycReuseShareTokenResponse
  - `code` integer — Business result code. 0 means success; business rejections return HTTP 200 with a non-zero code.
  - `message` string — Human-readable diagnostic for non-zero codes.
  - `data` object
    - `status` 'passed' | 'incomplete' | 'terminal' — Conclusive verdict for this handoff attempt. The envelope code mirrors it: passed maps to code 0, incomplete to 20004, terminal to a numeric eligibility code (30010, 30011, or 30012).
    - `applicantId` string — The imported applicant id in UR's Sumsub tenant. Present once the applicant is copied.
    - `attempt` integer — 1-indexed handoff attempt within this session.
    - `missingFields` string[] — Present on incomplete; machine paths of the gaps the user must remediate in your workflow.

---

[API](https://skmtc.net/ur/apis/ur-api.md) · [All operations](https://skmtc.net/ur/apis/ur-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ur/ur-api/revisions/087dcf516ce2/schema)