Sign in
Verification

Initiate a new verification

Creates a new verification session.

Authentication:

  • JWT token: Organization inferred from user's authenticated organization
  • API Key: Organization inferred from API key's associated organization

Customer handling:

  • If customerId is provided: Creates verification for existing customer
  • If customerId is omitted: Checks for existing customer by email. If found, uses existing customer. If not found, creates new customer with provided email/name details.

Idempotency:

  • Customer email must be unique within the organization
  • If an active verification session exists for the customer, returns the existing session
  • If a pending verification session exists for the customer, returns an error
post/v1/verification/initiate

Headers

X-API-Keystring

API key

Request body

type'INDIVIDUAL' | 'BUSINESS' required

Customer type

countryCodestring required

Country code (ISO 3166-1 alpha-2)

emailstring email required

Customer email address. Must be unique within the organization. If a customer with this email already exists, the existing customer will be used.

namestring required

Customer name

customerIdstring

Existing customer ID (optional)

fillOnBehalfboolean

When true, indicates the organization will fill out the verification on behalf of the customer. No reminder emails will be sent.

redirectUrlstring uri

URL to redirect the user to after verification is completed. When provided, the user will be automatically redirected to this URL after successfully completing the verification flow.

Example request

{
  "type": "INDIVIDUAL",
  "countryCode": "US",
  "email": "customer@example.com",
  "name": "John Doe",
  "customerId": "cus_abc123",
  "redirectUrl": "https://app.example.com/kyc-complete"
}

Response

Example response

{
  "verification": {
    "sessionId": "vsess_abc123",
    "verificationUrl": "https://verify.infinite.dev/?sessionId=vsess_abc123",
    "expiresAt": "2026-10-15T10:30:00Z"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.