latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

Managed Custody KYC

Check KYC data completeness

Pure read of the last handoff attempt's verdict on the shared-token path; use it as a fallback to the fma.kyc.reuse_check.result webhook. Poll every 30 seconds to 2 minutes and stop after submit succeeds. An incomplete session returns code 20004 with missingFields.

post/api/fma/v1/kyc/check

Headers

X-Ur-Idstring

The user's URID. Send at least one of X-Ur-Id or X-External-User-Id.

X-External-User-Idstring

Your partner-side user id. Send at least one of X-Ur-Id or X-External-User-Id.

X-Api-Signaturestring required

Partner Auth EIP-191 signature over the canonical message plus the deadline.

X-Api-Deadlinestring required

Unix timestamp in seconds after which the signature is no longer valid.

X-Api-PublicKeystring required

Partner public key used to verify the signature.

Request body

sessionIdstring required

The onboarding session UUID returned by create-account.

Response

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

codeinteger

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

messagestring

Human-readable diagnostic for non-zero codes.