Skip to main content
​
members
array
required
Array of members to verify. Each member requires first_name, last_name, email, ownership_percentage, role, and is_responsible_party.
curl -X POST https://api.usenaive.ai/v1/verification \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "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
      }
    ]
  }'

{
  "id": "verification-uuid",
  "status": "in_progress",
  "primary_link": "https://verify.usenaive.ai/?type=user#obtok_xxx",
  "members": [
    {
      "id": "member-uuid-1",
      "role": "primary",
      "is_responsible_party": true,
      "first_name": "Alice",
      "last_name": "Smith",
      "email": "alice@example.com",
      "ownership_percentage": 60,
      "status": "link_ready",
      "link": "https://verify.usenaive.ai/?type=user#obtok_xxx"
    },
    {
      "id": "member-uuid-2",
      "role": "secondary",
      "is_responsible_party": false,
      "first_name": "Bob",
      "last_name": "Jones",
      "email": "bob@example.com",
      "ownership_percentage": 40,
      "status": "link_sent",
      "link": "https://verify.usenaive.ai/?type=user#obtok_yyy"
    }
  ]
}
The primary member’s link is returned in primary_link for immediate use. Secondary members are emailed their links automatically. Ownership percentages must sum to 100, exactly one member must be primary, and exactly one must be is_responsible_party: true.
May require approval. If the user’s Account Kit gates verification.start, an agent (API-key) call returns 202 { "status": "pending_approval", "approval_id" } instead of starting KYC. A human approves it via Approvals; KYC begins on replay. See Approvals.