# FOV: Find or Verify

Email intelligence API. Pay-per-call in USDC on Solana via x402.
No account, no subscription, no API keys.

Base URL: https://fov.brij.fi

## Endpoints

GET /email-finder    $0.05
  Most likely email address for a person at a domain.
  Params:
    company: Company name (alternative to domain)
    domain (required): Company domain (e.g. stripe.com)
    first_name: First name of the person
    full_name: Full name (alternative to first_name + last_name)
    last_name: Last name of the person

GET /domain-search    $0.05
  All known email addresses at a domain.
  Params:
    company: Company name (alternative to domain)
    domain (required): Company domain
    limit: Max results (default 10)

GET /email-verifier    $0.03
  Verify email deliverability via MX/SMTP/disposable-domain checks.
  Params:
    email (required): Email address to verify

## Payment flow (x402)

  1. GET the endpoint with the query params above.
  2. Server replies 402 with `Payment-Required: <base64 requirements>`.
  3. Sign the USDC transaction on Solana per the x402 spec.
  4. Retry the same GET with `PAYMENT-SIGNATURE: <signature>`.
  5. Server replies 200 with `Payment-Response: <settled>` and a JSON body.

Any x402-compatible client handles this loop automatically.

## Discovery

  GET /openapi.json               OpenAPI 3.1 spec with x-payment-info
  GET /.well-known/x402           Resource manifest for x402scan / Bazaar
  GET /.well-known/ai-plugin.json Agent plugin manifest