Integrate from Any Stack — Without Pretending an Unpublished SDK Exists

import { randomUUID } from "crypto";

interface CreateJobOptions {
  service: "phone-validation" | "email-validation" | "carrier-lookup";
  inputs: string[];
  webhookUrl?: string;
  metadata?: Record<string, string>;
}

interface JobResponse {
  ok: boolean;
  data: {
    id: string;
    service: string;
    status: "queued" | "preparing" | "verifying" | "completed";
    item_count: number;
    max_quote_micros: number;
    created_at: string;
  };
}

export async function submitVerificationJob(options: CreateJobOptions): Promise<JobResponse> {
  const apiKey = process.env.PHONEVERIFLO_API_KEY;
  if (!apiKey) throw new Error("PHONEVERIFLO_API_KEY environment variable is required");

  const response = await fetch("https://api.phoneveriflo.com/api/v1/jobs", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json",
      "Idempotency-Key": randomUUID(),
    },
    body: JSON.stringify({
      service: options.service,
      inputs: options.inputs,
      webhook_url: options.webhookUrl,
      metadata: options.metadata,
    }),
  });

  if (!response.ok) {
    const errorData = await response.json().catch(() => ({}));
    throw new Error(errorData.error?.message || `Job submission failed with status ${response.status}`);
  }

  return response.json();
}

// Example usage:
const job = await submitVerificationJob({
  service: "phone-validation",
  inputs: ["+14155552671", "+447700900123"],
  webhookUrl: "https://api.myapp.com/webhooks/phoneveriflo",
});
console.log("Job Submitted ID:", job.data.id);