{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/generect-com/json-schema/generect-com-email-find-response-schema.json",
  "title": "EmailFindResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/generect-com-7-email-api-openapi.yml#/components/schemas/EmailFindResponse",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "description": "The email finder result. valid_email is null when no email is found.",
      "properties": {
        "lead_id": {
          "type": "string",
          "description": "Echoed back when the request was made by lead_id."
        },
        "valid_email": {
          "type": [
            "string",
            "null"
          ],
          "description": "The found verified email, or null if none was found."
        },
        "result": {
          "type": "string",
          "description": "Outcome: valid, invalid, or unknown."
        },
        "catch_all": {
          "type": "boolean",
          "description": "True if the domain is catch-all."
        },
        "source": {
          "type": "string",
          "description": "Where the email was resolved (e.g. generect, findymail, FORMAT)."
        },
        "email_format": {
          "type": "string",
          "description": "Detected address pattern for the domain."
        },
        "mx_domain": {
          "type": "string",
          "description": "Mail exchanger domain."
        }
      }
    },
    "meta": {
      "$ref": "#/$defs/Meta"
    }
  },
  "$defs": {
    "Meta": {
      "type": "object",
      "description": "Operation metadata returned in every data/meta response.",
      "required": [
        "amount_charged"
      ],
      "properties": {
        "amount_charged": {
          "type": "number",
          "description": "Actual amount charged for this request in USD, computed from your pricing tier. 0 for free operations and for not-found results (No Data — No Charge)."
        },
        "status": {
          "type": "string",
          "description": "Set to \"error\" when the operation finished with an error."
        },
        "error": {
          "type": "string",
          "description": "Error details; present only when the operation failed."
        },
        "time_cached": {
          "type": "string",
          "format": "date-time",
          "description": "When the cached result set was originally collected (returned by database company search when results are served from a previous identical search)."
        },
        "free_tier": {
          "type": "object",
          "description": "Present only on a database lead or company search sent with `\"detail\": \"thin\"`: where your account stands against today's free row quota. The quota resets at 00:00 UTC.",
          "properties": {
            "detail": {
              "type": "string",
              "enum": [
                "thin"
              ]
            },
            "daily_rows": {
              "type": "integer",
              "description": "Free thin rows per account per UTC day."
            },
            "rows_used_today": {
              "type": "integer",
              "description": "Thin rows returned to your account today, this page included."
            },
            "rows_left_today": {
              "type": "integer",
              "description": "Thin rows your account can still take today."
            }
          }
        }
      }
    }
  }
}