Start Verification

array

required

Array of members to verify. Each member requires first_name, last_name, email, ownership_percentage, role, and is_responsible_party.

Show Member object

string

required

Legal first name

string

required

Legal last name

string

required

Email address (used for KYC link delivery)

string

Phone number in E.164 format (optional, pre-fills KYC form)

integer

required

0-100, must sum to 100 across all members

string

required

"primary" (exactly one) or "secondary"

boolean

required

IRS-facing person for formation (exactly one must be true)

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.

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" } ] }