Create Verification Flow

Endpoint

GET /v1/flows/verification

Base URL: https://api-id.avnology.net

Authentication: None required

Creates a verification flow for confirming an email address or phone number. Typically used after registration or when a user changes their email.

Request

Query Parameters

Parameter	Type	Required	Description
`return_to`	string	No	URL to redirect after verification completes
`email`	string	No	Pre-fill the email field

Example Request

curl "https://api-id.avnology.net/v1/flows/[email protected]" \
  -H "Accept: application/json"

Response

Success (200 OK)

{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "type": "verification",
  "state": "show_form",
  "expires_at": "2026-04-08T13:00:00Z",
  "issued_at": "2026-04-08T12:00:00Z",
  "ui": {
    "action": "https://api-id.avnology.net/v1/flows/verification/b2c3d4e5-f6a7-8901-bcde-f12345678901:submit",
    "method": "POST",
    "nodes"

Code Examples

JavaScript (fetch)

async function createVerificationFlow(email) {
  const url = new URL('https://api-id.avnology.net/v1/flows/verification');
  if (email) url.searchParams.set('email', email);
  const response = await fetch(url);
  return response.json

Python (httpx)

import httpx

def create_verification_flow(email: str | None = None) -> dict:
    params = {"email": email} if email else {}

Go (net/http)

func createVerificationFlow(ctx context.Context, email string) (*AuthFlow, error) {
	u, _ := url.Parse(

Submit Verification -- submit the verification code
SDK: client.auth.verifyEmail(code) (TypeScript)

Create Verification Flow

On this page