Complete Member Verification

string

required

UUID of the member who completed KYC.

string

required

verification validation token from the onComplete callback after the member finishes the hosted KYC flow.

curl -X POST https://api.usenaive.ai/v1/verification/members/member-uuid/complete \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"validation_token": "valtok_xxx"}'

{
  "id": "member-uuid",
  "role": "primary",
  "is_responsible_party": true,
  "first_name": "Alice",
  "last_name": "Smith",
  "email": "alice@example.com",
  "ownership_percentage": 60,
  "status": "pass",
  "fp_id": "fp_id_xxx",
  "link": null,
  "link_expires_at": null,
  "completed_at": "2026-05-04T10:03:00.000Z",
  "created_at": "2026-05-04T10:00:00.000Z"
}

This endpoint validates the token with the verification provider’s POST /onboarding/session/validate and immediately updates the member’s status and fp_id. Use this for the primary member who completes KYC in-browser to get instant feedback without waiting for the webhook fallback. If the member already has a terminal status (pass or fail), the current record is returned without re-validating.

curl -X POST https://api.usenaive.ai/v1/verification/members/member-uuid/complete \ -H "Authorization: Bearer nv_sk_live_..." \ -H "Content-Type: application/json" \ -d '{"validation_token": "valtok_xxx"}'

{ "id": "member-uuid", "role": "primary", "is_responsible_party": true, "first_name": "Alice", "last_name": "Smith", "email": "alice@example.com", "ownership_percentage": 60, "status": "pass", "fp_id": "fp_id_xxx", "link": null, "link_expires_at": null, "completed_at": "2026-05-04T10:03:00.000Z", "created_at": "2026-05-04T10:00:00.000Z" }