Skip to main content
​
id
string
required
UUID of the verification to retrieve.
curl https://api.usenaive.ai/v1/verification/verification-uuid \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "id": "verification-uuid",
  "company_id": "company-uuid",
  "status": "in_progress",
  "ready_for_formation": false,
  "kyc_playbook_key": "pb_live_xxx",
  "metadata": null,
  "created_at": "2026-05-04T10:00:00.000Z",
  "updated_at": "2026-05-04T10:05:00.000Z",
  "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": "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"
    },
    {
      "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",
      "fp_id": null,
      "link": "https://verify.usenaive.ai/?type=user#obtok_yyy",
      "link_expires_at": "2026-05-05T10:00:00.000Z",
      "completed_at": null,
      "created_at": "2026-05-04T10:00:00.000Z"
    }
  ]
}
ready_for_formation is true only when every member has status: "pass". Use this as the gate signal before submitting to a formation provider.