Skip to main content

​
Overview

CommandDescriptionCost
naive verification start --members <json>Start KYC for a set of membersFree
naive verification listList all verification requestsFree
naive verification status <id>Get verification + member statusesFree
naive verification complete <memberId> --token <token>Submit validation tokenFree
naive verification resend <memberId>Resend a member’s KYC linkFree

​
Start Verification

Starts identity verification for one or more company founders/members. Each member gets a hosted KYC link. 
naive verification start --members '[
  {"first_name":"Alice","last_name":"Smith","email":"alice@example.com",
   "ownership_percentage":60,"role":"primary","is_responsible_party":true},
  {"first_name":"Bob","last_name":"Jones","email":"bob@example.com",
   "ownership_percentage":40,"role":"secondary","is_responsible_party":false}
]'

​
Rules

  • Exactly one member must have role: "primary"
  • Exactly one member must have is_responsible_party: true
  • Ownership percentages must sum to 100
  • Primary member’s KYC link is returned in the response
  • Secondary members are emailed their KYC links

​
Member Fields

FieldTypeRequiredDescription
first_namestringYesLegal first name
last_namestringYesLegal last name
emailstringYesEmail address
phone_numberstringNoE.164 format
ownership_percentageintegerYes0-100, sum must be 100
rolestringYes"primary" or "secondary"
is_responsible_partybooleanYesIRS-facing person (exactly one)

​
Output

{
  "success": true,
  "action": "verification.start",
  "result": {
    "id": "verification-uuid",
    "status": "in_progress",
    "primary_link": "https://verify.usenaive.ai/?type=user#obtok_xxx",
    "members": [
      { "id": "member-uuid-1", "role": "primary", "status": "link_ready", "link": "https://..." },
      { "id": "member-uuid-2", "role": "secondary", "status": "link_sent", "link": "https://..." }
    ]
  },
  "next_steps": [
    { "command": "Open https://verify.usenaive.ai/...", "description": "Primary member: complete KYC in browser" },
    { "command": "naive verification status verification-uuid", "description": "Check verification progress" }
  ]
}

​
List Verifications

naive verification list

{
  "success": true,
  "action": "verification.list",
  "result": {
    "verifications": [
      { "id": "verification-uuid", "status": "in_progress", "ready_for_formation": false, "member_count": 2, "members_verified": 1 }
    ]
  }
}

​
Check Status

naive verification status <verification-id>

{
  "success": true,
  "action": "verification.status",
  "result": {
    "id": "verification-uuid",
    "status": "in_progress",
    "ready_for_formation": false,
    "members": [
      { "id": "member-uuid-1", "status": "pass", "email": "alice@example.com" },
      { "id": "member-uuid-2", "status": "link_sent", "email": "bob@example.com" }
    ]
  },
  "hints": ["Status: in_progress", "Ready for formation: false", "1/2 members verified"]
}

​
Complete Member Verification

After a member finishes KYC in the browser, submit the verification validation token: 
naive verification complete <member-id> --token valtok_xxx

{
  "success": true,
  "action": "verification.complete",
  "result": { "id": "member-uuid", "status": "pass", "email": "alice@example.com" }
}
Regenerate and resend a KYC link for a member whose link expired or was lost: 
naive verification resend <member-id>

{
  "success": true,
  "action": "verification.resend",
  "result": { "id": "member-uuid", "link": "https://verify.usenaive.ai/...", "status": "link_sent" }
}